To fix invalid configuration fields, please follow the instructions below.

Some background information

If you are unable to save your configuration and/or receive a message to this effect when saving (e.g. "Invalid configuration"), this is usually due to an incorrectly filled configuration field.

If an error occurs, you have the following two options:

1. You filled a field incorrectly before saving.

   • The incorrect value will not be applied. Reload the configuration and everything will be fine again.

2. You filled in a field incorrectly before updating to Shopware 6.7.

   • You must now find the value and correct it.

In this article, we assume that you have already validated the configuration and received a message indicating the incorrect field.

If you have not yet validated the configuration, please proceed as described in the following article:

Let's assume you receive the message SCSS Value "#9fa5ab;" is not valid for type "color" or SCSS Value "none" is not valid for type "color". Both are variants of the same problem, an incorrectly filled colour configuration.

In the first case, a copying error has crept in and a semicolon has been added: #9fa5ab;. In the second case, the value none has been inserted. The value none is not a valid value for a CSS/SCSS colour field. Use transparent or rgba(255, 255, 255, 0) to "remove" a colour.

1. Open the administration of your shop

2. Open your theme configuration

3. Search each tab with your browser (e.g. Ctrl + F) for the incorrect value (e.g. #9fa5ab; or none )

Your theme should now be saved again.

For more information about the "Invalid configuration" error, please refer to the following article:

In order to check whether an error or problem is caused by a specific extension (plugin or app), please follow the steps below:

Extensions can be examined in 3 steps:

1. Deactivate extensions (do not uninstall!)

2. Clear the Shopware cache

3. Clear the browser cache

1. Open the administration of your shop

2. Deactivate extensions:

   1. Navigate via the main navigation to the Extension Management ("Extensions" => "My extensions" => Tab "Apps")

If the problem does not occur anymore, ThemeWare® is not the cause and there is a problem with an extension (plugin or app).

To ensure that any issues have not already been resolved with an update, it makes sense to update Shopware, all Extensions (Apps or Plugins) and ThemeWare® itself to the latest version.

Update the entire shop:

1. Update Shopware to the latest version:

   1. Navigate via the main navigation to the "Shopware updater" ("Settings" => "System" => "Shopware Update")

   2. Click on the button "Check for updates"

   3. Update Shopware if a newer version is available

2. Update all Extensions (Apps or Plugins) to the latest version:

   1. Navigate via the main navigation to the "Extension Management" ("Extensions" => "My Extensions")

   2. Check the tab "Apps" if there are any updates available
3. Update ThemeWare® to the latest version:

   1. Check in the tab "Themes" if there is an update for ThemeWare®

   2. Check in the if there is an update for ThemeWare®

In rare cases, issues arise because files from Extensions (Plugins, Apps or Themes) have not been completely transferred to the Storefront. In the case of ThemeWare® this can be solved with a "Soft Reset".

Performing a ThemeWare® Soft Reset:

1. Assign the Shopware default theme to your sales channel:

   1. Navigate via the main navigation to your sales channel ("Sales Channels" => "..." => Tab "Theme")

   2. Please assign the Shopware default theme to the appropriate sales channel

2. Deactivate (do not uninstall!) ThemeWare®:

   1. Switch via the main navigation to the "Extension Management" ("Extensions" => "My Extensions")

   2. Switch to the tab "Themes"
3. Activate ThemeWare® again:

   1. Activate ThemeWare® via the switch button on the left of the ThemeWare® logo

4. Assign ThemeWare® to your sales channel again:

   1. Switch via the main navigation to the sales channel of your Storefront in the section "Sales Channels"

   2. Switch to tab "Theme"
5. Clearing the Shopware cache:

   1. Navigate via the main navigation to the section "Cache & Indexes" ("Settings" => "System")

   2. Click "Clear caches "

6. Reloading the website and the browser cache:

   • After that, reload the page on which the problem occurred in your web browser with a cache refresh:

     • Windows: Ctrl + F5

The first step in case of problems or supposed errors always is to have a look at the "Frequent errors" section. There you will find solutions for the most common, known problems and errors for both the storefront and the administration.

Due to our more than 3,000 customers, we have already seen and solved almost every problem. Therefore, it is very likely that the problem is already known and a solution already exists.

Therefore, always check the "Frequent Errors" section first:

We have committed ourselves to providing the best experience for you and your customers with ThemeWare®. As you see from our over 380 evaluations, we care a lot about providing awesome support.

With more than 3,000 customers, we have seen and solved almost every problem countless times. Please trust us, as well as this process and follow the instructions step by step.

More than 95% of all problems are not caused by ThemeWare®. It is very likely that you will be able to solve the problem yourself with the help of this process and you will not have to wait for an answer from our side.

Possible reasons:

• the problem results from an outdated storefront

• the problem already exists in the Shopware default theme

• the problem arises from (an) individual adaptation(s)

• the problem is caused by (a) third party extension(s)

All this can be checked by our process and if you can't solve the problem yourself, you will automatically open a support ticket during this process. However, it is absolutely necessary to follow the steps exactly. Only this way we will be able to provide our excellent support everyone loves so much.

Please start troubleshooting now under:

In rare cases, issues arise because files from Extensions (Plugins, Apps or Themes) have not been completely transferred to the Storefront. In the case of ThemeWare® this can be solved with a "Soft Reset" (see Performing a ThemeWare® Soft Reset).

If this is not sufficient (e.g. in the case of incorrect file permissions due to manual editing of source files), the only thing that can be done is to reinstall ThemeWare®:

Reinstall ThemeWare®:

1. Recommended: Create a full backup of your shop

2. Assign the Shopware default theme to your sales channel:

   1. Navigate via the main navigation to your sales channel ("Sales Channels" => "..." => Tab "Theme")

   2. Please assign the Shopware default theme to the appropriate sales channel

3. Deactivate ThemeWare®:

   1. Switch via the main navigation to the "Extension Management" ("Extensions" => "My Extensions")

   2. Switch to the tab "Themes"
4. Uninstall ThemeWare® (without removing the app data):

   1. Click on the context button next to the theme to open the context menu and click on "Uninstall".

   2. IMPORTANT : Uncheck the option "Remove all app data permanently" in the following pop-up to keep your theme configuration!

5. Install ThemeWare® again:

   1. Install ThemeWare® again by clicking on "Install"

6. Activate ThemeWare® again:

   1. Activate ThemeWare® via the switch button on the left of the ThemeWare® logo

7. Assign ThemeWare® to your sales channel again:

   1. Switch via the main navigation to the sales channel of your Storefront in the section "Sales Channels"

   2. Switch to tab "Theme"
8. Clearing the Shopware cache:

   1. Navigate via the main navigation to the section "Cache & Indexes" ("Settings" => "System")

   2. Click "Clear caches "

9. Reloading the website and the browser cache:

   • After that, reload the page on which the problem occurred in your web browser with a cache refresh:

     • Windows: Ctrl + F5

For representation errors in the storefront an outdated cache is the cause in most of the cases. An incorrectly compiled theme as well can lead to representation errors.

Therefore, in case of problems or representation errors, please always update the Shopware Storefront first. With just a few clicks this can be done easily and quickly:

In order to examine whether an error or problem is caused by an individual customization, please follow the instructions below:

You can examine individual customizations in 5 steps:

1. Exclude theme duplicate (if used)

2. Exclude individual customizations (if used)

3. Exclude individual code

4. Clear Shopware cache

5. Clear browser cache

1. Open the administration of your shop

2. Exclude theme duplicate (if used):

   1. Navigate via the main navigation to your sales channel ("Sales Channels" => "..." => Tab "Theme")

If the problem no longer occurs, ThemeWare® is not the cause and there is a problem with your individual customizations.

In order to check whether an error or problem could be related to ThemeWare® at all, it is sufficient to assign the Shopware default theme to your sales channel. Just follow the instructions below:

The Shopware default theme can be examined in 3 steps:

1. Assign Shopware default theme

2. Clear Shopware cache

3. Clear browser cache

1. Open the administration of your shop

2. Assign the Shopware default theme:

   1. Navigate via the main navigation to your sales channel ("Sales Channels" => "..." => Tab "Theme")

In case the problem still occurs – even without ThemeWare® – it is 99.9% likely that ThemeWare® is not the cause and that there is a fundamental problem in Shopware or with an extension (plugin or app).

Next, examine whether a particular extension is causing the error or problem: