All pages
Powered by GitBook
1 of 49

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Oops! An Error Occurred

Description

The error "Oops! An Error Occurred" appears in the storefront.

Oops! An Error Occurred

The server returned a "500 Internal Server Error".

Something is broken. Please let us know what you were doing when this error occurred. We will fix it as soon as possible. Sorry for any inconvenience caused.

Causes

The error "Oops! An Error Occurred" is a common error that is displayed when a technical problem occurs and a certain feature or page cannot be loaded properly. There are several possible causes for the error "Oops! An Error Occurred" error in Shopware.

  • Incompatible extensions or themes: Extensions that are not compatible with the current Shopware version can cause the error.

  • Missing, outdated or faulty files: Corrupted, outdated, or missing files can cause the error.

  • Incorrect settings: Incorrect settings can cause the error.

  • Database issues: Corrupted or missing entries in the database can cause the error.

  • Server issues: Insufficient resources, incorrect configurations, or network problems on the server can cause the error.

To resolve the error effectively, you should proceed systematically. The following steps will help you identify potential causes and fix the issue.

  • Check extensions and themes: Ensure all extensions are compatible with the current Shopware version. Update all extensions and temporarily disable any incompatible ones.

  • Clear cache: Clear the entire Shopware cache (possibly via FTP).

  • Check files and configurations: Ensure all required files are present and the Shopware configuration is correct.

  • Update Shopware:

The "Oops! An Error Occurred" error in Shopware can be resolved through a systematic check of extensions, themes, the database, and the server environment.

If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

Update to the latest version of Shopware, as bugs may have been fixed in newer versions.
  • Check the database: Inspect the database for potential issues, for example using tools like phpMyAdmin. Contact your hosting provider for assistance with the check.

  • Check the server environment: Ensure that sufficient resources are available.

  • Check error logs: Review the PHP error log and Shopware error logs for clues to the exact cause of the error.

  • Note: In our experience, the error often occurs in connection with updates of extensions and themes, where incompatibilities are usually caused by manual updates. Therefore, we recommend always using our when performing updates.

    Solutions

    Tip: It is especially important to keep Shopware and all extensions up to date and regularly check their compatibility!

    Issue not solved?

    Update guide

    Branding is shown despite Licence Key

    Description

    The branding ("Theme by ThemeWare®") is displayed in the Storefront even though you have entered a Licence Key in the theme configuration.

    Basic information

    If you want to remove the ThemeWare® branding, you can purchase a license from us. If you are interested, the fastest way to contact us is here.

    Solution

    1. Check once again that you have selected the correct ThemeWare® version for your licence key.

    2. Check whether you have entered the licence key correctly. (Sometimes, for example, spaces are entered before or after the Licence Key.)

    3. Recompile the theme once.

    4. Clear the Shopware and your Browser cache completely.

    5. Check whether you have installed the plugin "" and delete it completely from your shop. The plugin is explicitly intended only for the default Shopware theme.

    Configuration fields are missing

    One or more configuration fields are missing in the theme configuration although they are listed in the ThemeWare® Config Finder or the ThemeWare® Documentation.

    If one or more configuration fields are missing in the theme configuration, there are two possible causes:

    1. Most likely you are not using the latest version of ThemeWare®.

    2. There was a problem with a Shopware or ThemeWare® update.

    Both the ThemeWare® Documentation and the are based on the latest version of ThemeWare®. If you find a feature or configuration there that is missing in your shop, you are probably not using the latest version of ThemeWare®.

    Remove or replace copyright

    Check whether you are using the latest version of ThemeWare® and update your theme if necessary.

    Tip: You can see which version is the latest in the , for example.

    Configuration fields are managed by the Shopware Core. ThemeWare® has no feature that adds or removes fields, so unfortunately we have no influence on this.

    It may be that an old version of the administration was cached. Please reload the administration with the following key combination:

    • Windows: Ctrl + F5

    • Mac: Command (⌘) + Shift (⇧) + R or Command (⌘) + Option/Alt (⌥) + R

    If this does not help, the issue is a bit bigger. Please perform a "Soft Reset" of ThemeWare® using the following instructions:

    Description

    Note: This issue relates to the original theme and not to duplicates. For missing configuration fields in ThemeWare® duplicates, please refer to the article .

    Cause

    Solution

    1) Update ThemeWare®

    ThemeWare® Config Finder

    Note: If you are unable to update ThemeWare®, please take a look at the following article: .

    2) Resolve update errors

    Other solutions

    ThemeWare® Changelog
    Performing a ThemeWare® Soft Reset
    New configuration fields are missing in a theme duplicate after update
    ThemeWare® update not available

    Storefront

    Here you can find solutions to the most common issues in the Shopware 6 storefront.

    • Branding is shown despite Licence Key

    • CMS blocks are not displayed in Shopping Experience

    • Gallery sliders have a wrong height on mobile devices

    Listing subcategories are not displayed

    Unfortunately, the ThemeWare® CMS block "Listing subcategories" does not display any subcategories.

    As the name suggests, the CMS extension "Listing subcategories" only works on CMS pages of the type "Listing page". In addition, subcategories in Shopware 6 are only displayed for the main category.

    Create a CMS layout of the type "Listing page", add the CMS block "Listing subcategorie" and assign the layout to the desired category. Also make sure that the corresponding category page is in a main category.

    Description

    Cause

    Solution

    Header overlays the Shopping Experience on the home page
    Listing subcategories are not displayed
    Oops! An Error Occurred
    Pop-up (e.g. privacy) is displayed without content
    Privacy pop-up is displayed without content
    Representation errors in the storefront
    Representation errors with a theme duplicate after an update
    Shipping costs pop-up is displayed without content
    Sticky top navigation does not work
    T&C pop-up is displayed without content
    Unfortunately something went wrong on the product page

    Pop-up (e.g. privacy) is displayed without content

    Description

    One or more pop-ups or modals remain empty and do not display any content. This can affect, for example, the "Privacy" and/or "Terms and Conditions" modal from the footer and/or the "Shipping Costs" modal on the product page.

    Cause

    This is not a theme "problem" or "bug" but a missing or incomplete Shopware configuration.

    In order for shop pages to be displayed in modals (pop-ups), they must be created as Shopping Experience layouts and assigned in the Shopware settings.

    Solution

    1. Create the corresponding shop page as a Shopping Experience layout ("Contents" => "Shopping Experience" => "Shop pages")

    2. Assign this shop page layout via the Shopware settings to your storefront zu ("Settings" => "Shop" => "Basic information" => "Shop pages")

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Representation errors in the storefront

    Description

    -

    Cause

    Most representation errors in the storefront result from an outdated browser or Shopware cache.

    Solution

    You can easily solve most of the representation errors in Shopware 6 yourself without having to wait for us.

    In our article How can I fix representation errors? we show you two simple steps to fix representation errors and what is the best way to proceed if these steps do not help.

    Issue not solved?

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Administration not accessible

    Your administration is not accessible after a Shopware update (or shows a white page).

    You probably have an incompatible extension active in your system.

    In rare cases, an extension may not be compatible with the old and the new Shopware version at the same time. If you activate an incompatible extension or do not deactivate it before the Shopware update, the administration may no longer be accessible.

    Deactivate the corresponding extension (or all extensions) via the database. The administration should then be accessible again.

    Update all extensions and only activate them once you have ensured that they are installed in a compatible version.

    In the following instructions, we show you how to deactivate an extension via the database using ThemeWare® as an example:


    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Common issues

    Here you can find solutions to the most common issues and errors in the Shopware 6 storefront.

    Caused by our experiences with more than 3,000 customers, we have already seen and solved almost every issue. It is therefore very likely that the problem is already known and that there is already a solution.

    Tip: In case of any issues, always take a look at the "Common Issues" section. Here you will find solutions to the most common issues and errors for both, the storefront and the administration.

    Storefront
    Administration

    Note: You can find more information in the article .

    Issue not solved?

    Description

    Cause

    Solution

    Issue not solved?

    Deactivating ThemeWare® via the database

    Configuration fields in the "General" tab

    You may find configuration fields (usually titled "twt-...") in the "General" tab of the ThemeWare® configuration that have no effect.

    These are "orphaned configuration fields". These occur when a configuration field has been edited by the user at some point and this configuration field is deleted with a theme update.

    Unfortunately, the Shopware update routine currently does not automatically remove those configuration fields.

    In response to our issue (NEXT-14571), Shopware has extended the "Save" button in the theme configuration in Shopware 6.4.8.0 and added a "Clean" option. This allows you to delete "orphaned configuration fields".

    You can find out how to remove "orphaned configuration fields" in the article .

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Features or configurations are missing

    If you are missing one or more features or configurations that you can find in the ThemeWare® Documentation or in the ThemeWare® Config Finder, take a look at the following article:

    Configuration fields are missing

    Description

    Cause

    Note: With ThemeWare® you benefit from continuous development. From time to time it may happen that configuration fields are removed or replaced with an update.

    Solution

    Issue not solved?

    Cleaning up ThemeWare®
    Orphaned configuration fields automatically end up in the "General" tab."
    Shop pages

    Unfortunately something went wrong on the product page

    Description

    The error "Unfortunately, something went wrong." appears on the product page if you use our "ThemeWare® Customizing Plugin".

    Cause

    In this case, the cause is an outdated version of the extension or an outdated customisation.

    Solution

    1. Please remove the content in the following files:

      1. File "main.scss":

        • Delete everything

        • File location: custom/plugins/TcinnCustomizing/src/Resources/app/storefront/src/scss/

      2. File "headline.html.twig":

        • Delete everything from line 2

        • File location: custom/plugins/TcinnCustomizing/src/Resources/views/storefront/page/product-detail/

    2. Then refresh the storefront once to transfer the changes to the storefront:

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Administration

    Here you can find solutions to the most common issues in the Shopware 6 administration.

    $color2: 0 is not a color

    You get the error message Unable to compile the theme "TcinnThemeWare...". $color2: 0 is not a color.

    Crucial is the part directly after the message Unable to compile the theme "TcinnThemeWare...". It says $color2: 0 is not a color.

    This error message is due to the new validation of the theme configuration as of Shopware 6.6.9.

    Check whether you are using empty colour configuration fields. Empty colour fields are usually not valid and lead to this error message. Fill empty colour fields to be able to compile your theme again.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Theme could not be assigned to sales channel

    When assigning the theme to a sales channel, the error message "Theme could not be assigned to Sales Channel." appears.

    Unfortunately, the error message is not very significant. A more detailed error message is needed to solve the problem.

    How to get a detailed error message please find in the article .

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    CMS blocks are not displayed in Shopping Experience

    The Shopping Experience layout has been assigned but the CMS blocks are not displayed in the storefront.

    ThemeWare® provides "CMS animations". With this feature, CMS blocks are hidden and displayed with a CSS animation when the CMS page is scrolled as soon as the corresponding CMS block comes into the viewable area of the browser window.

    This animation is managed by JavaScript.

    If the CMS blocks are not displayed as intended, there is a 99.9% chance that you will find one or more error messages in the browser DevTools that refer to JavaScript errors.

    JavaScript errors caused by third-party extensions can affect ThemeWare® JavaScript features. In this case the scroll animation is obviously affected.

  • Administration not accessible
    Allowed memory size of ... bytes exhausted
    Bad Request...
    Fix the JavaScript error. It often helps to update all extensions.
    • If you want to know which extension is causing the error, deactivate (do not uninstall!) all extensions used once. If the problem no longer exists after deactivating all extensions, the problem is most likely due to one extension.

    • Now activate your extensions one after the other and check after each activated extension whether the error occurs again.

    • You can find more information in the article:

  • Deactivate the CMS animations

    • Tab "Shopping Experiences" => Block "All types (Shop pages, Landing pages, Listing pages, Product pages)" => Section "CSS scroll animations" => CSS scroll animation (CMS blocks)

    • Tab "Shopping Experiences" => Block "All types (Shop pages, Landing pages, Listing pages, Product pages)" => Section "CSS scroll animations" => CSS scroll animation (Headlines in CMS blocks)

  • Description

    Basic information

    Cause

    Solutions

    Issue not solved?

    Refreshing the storefront

    Description

    Cause

    Solution

    Note: This is an individual error, as ThemeWare® only delivers validly filled configuration fields by default.

    Note: If the validation flags correctly filled colour fields as errors, in our experience this is caused by third-party extensions. Disable all extensions and then repeat the validation.

    Issue not solved?

    Description

    Cause

    Solution

    Note: In our experience, the PHP memory_limit is usually the cause of such problems. More information can be found in the article .

    Issue not solved?

    Debugging error messages

    Error: argument '$color'

    You get the error message Unable to compile the theme "TcinnThemeWare...". $color: 0 is not a color.

    Crucial is the part directly after the message Unable to compile the theme "TcinnThemeWare...". It says $color: 0 is not a color.

    This error message is due to the new validation of the theme configuration as of Shopware 6.6.9.

    Check whether you are using empty colour configuration fields. Empty colour fields are usually not valid and lead to this error message. Fill empty colour fields to be able to compile your theme again.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    $color: 0 is not a color
    $color2: 0 is not a color
    Configuration fields are missing
    Configuration fields in the "General" tab
    Configuration required. Please fill in data in all elements.
    Error 400 / Theme cannot be saved
    Error 500 / Themes cannot be saved
    Error: argument '$color'
    Error compiling theme
    Errors occurred. Please check the error list in the editor.
    Features or configurations are missing
    Invalid configuration
    New configuration fields are missing in a theme duplicate after update
    Parse error: failed at $...
    Preview images in the Shopping Experience editor show placeholder images
    Saving the theme configuration takes a very long time
    SCSS Value "..." is not valid for type "color"
    Simplified representation of the theme configuration
    Some blocks were not configured sufficiently
    Theme could not be assigned to sales channel
    ThemeWare® cannot be updated
    ThemeWare® update not available
    Unable to compile theme
    Unable to compile the theme...
    Unable to deactivate or uninstall theme
    Unable to find the theme
    Undefined variable $...
    Examining extensions or plugins

    Description

    Cause

    Solution

    Note: This is an individual error, as ThemeWare® only delivers validly filled configuration fields by default.

    Issue not solved?

    Allowed memory size of ... bytes exhausted

    T&C pop-up is displayed without content

    The pop-up or modal for "Terms and Conditions" (e.g. in the footer) opens, but remains empty.

    This is not a theme "problem" or "bug" but a missing or incomplete Shopware configuration.

    More information and instructions on how to solve this "issue" can be found in the following article .

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Description

    Cause

    Solution

    Issue not solved?

    Pop-up (e.g. privacy) is displayed without content

    Errors occurred. Please check the error list in the editor.

    When saving your Shopping Experience, you receive the error message "Some blocks were not configured sufficiently." or "Errors occurred. Please check the error list in the editor.".

    Shopware usually indicates that you have not completely filled in all mandatory fields of a CMS element.

    Fill in all mandatory fields of your newly added CMS elements. These are often image fields or missing products in product sliders.

    You can find more information in the following article:

    Description

    Cause

    Solution

    Some blocks were not configured sufficiently

    Invalid configuration

    Description

    When saving the theme, you will receive the error message Invalid configuration – The configuration is faulty. The theme cannot be saved.

    Cause

    The message suggests that an error has occurred during the compilation of the storefront (Shopware Core + theme + customisations + extensions).

    This error usually occurs when saving the theme, as this triggers the compilation process.

    We are currently aware of two source texts:

    1. Usually, the issue is simply down to a configuration field that has been filled in incorrectly, for example, containing the wrong value.

    2. However, as described above, it can also occur due to an error in a customisation or third-party extension.

    However, as described above, it can also occur due to an error in a customisation or third-party extension.

    Why hasn't this error been noticed before?

    You may not have noticed this error in Shopware 6.6. However, with Shopware 6.7, the validation of the theme configuration has been significantly improved so that even minor typos are now reliably detected.

    There are two ways to resolve this error:

    1. You have entered an incorrect value:

      • As the configuration could not be saved, the incorrect value was not applied. Reload the configuration and you can continue as normal.

    2. The value was already incorrect before the update from Shopware 6.6 to 6.7.

      • Try the theme configuration validation to get more info. For example:

    You can find more information about validation in the following article:

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Allowed memory size of ... bytes exhausted

    Description

    If you find the message "Allowed memory size of ... bytes exhausted" in the PHP error log or in the Shopware log files, the issue is caused by the PHP memory_limit.

    Cause

    The error message "Allowed memory size exhausted" is one of the most common issues in shop or content management systems, especially if you are using a shared hosting service.

    This means that the web server limits the amount of memory used by Shopware and the memory provided is not sufficient.

    Solution

    The decisive factor in this error is the PHP memory_limit of your web server.

    Shopware recommends a memory_limit of "512 MB or higher". Please increase the memory_limit of your web server to the value recommended by Shopware (or higher).

    In case you do not know how to change the value, your hoster will certainly be happy to help you.

    Important: Even if your hosting (especially shared hosting) indicates a sufficient memory limit, it is not automatically for sure that you will receive that amount. Contact your hoster or agency to have it checked.

    Issue not solved?

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    No default folder for entity "cms_page" found

    You get the error message No default folder for entity "cms_page" found if you want to import the Shopping Experience into your ThemeWare® theme.

    Internal Server Error No default folder for entity "cms_page" found, please make sure that basic data is available by running the migrations.

    The sample images of our Shopping Experiences are installed in the standard folder ‘CMS Media’ during import. This folder is usually already available in Shopware. If the folder has not been created or has been removed for any reason, the images cannot be imported.

    All you need to do is create the appropriate standard folder. Please refer to our instructions below:

    Once you have created the folder, you can easily install/activate the plugin.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    $color: 0 is not a color

    You get the error message Unable to compile the theme "TcinnThemeWare...". $color: 0 is not a color.

    Crucial is the part directly after the message Unable to compile the theme "TcinnThemeWare...". It says $color: 0 is not a color.

    This error message is due to the new validation of the theme configuration as of Shopware 6.6.9.

    Check whether you are using empty colour configuration fields. Empty colour fields are usually not valid and lead to this error message. Fill empty colour fields to be able to compile your theme again.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Bad Request...

    Variants of the error with the title "Bad request":

    Unable to deactivate or uninstall theme
    Unable to find the theme
    • SCSS Value "#eeeee" is not valid for type "color"

      • correct would be #eeeeee (6x e, not 5x)

    • SCSS Value "#9fa5ab;" is not valid for type "color"

      • correct would be #9fa5ab (without a semicolon at the end)

    • SCSS Value "none" is not valid for type "color"

      • correct would be rgba(0, 0, 0, 0) (transparent colour)

    • SCSS Value 'color' cannot be 'none'

      • correct would be rgba(0, 0, 0, 0) (transparent colour)

  • If, for example, the validation gives you a colour value as the cause of the error, search your configuration for the incorrect value and correct it.

  • Disable ALL customisations and extensions, then check again to see if you can save. If the error no longer occurs, it is caused by a customisation or extension.

    • Tip: With ThemeWare® Debugging, you can easily narrow down errors in extensions – step by step.

  • Note: In the cases identified so far, the error was usually caused by an incorrectly configured colour scheme. However, there have also been instances where the problem was caused by a fault in a third-party extension.

    Tip: Use Shopware's colour picker to obtain a valid colour value.

    Solution

    Issue not solved?

    Validate the theme configuration

    Description

    Cause

    Solution

    Issue not solved?

    Create default folder for media

    Description

    Cause

    Solution

    Note: This is an individual error, as ThemeWare® only delivers validly filled configuration fields by default.

    Note: If the validation flags correctly filled colour fields as errors, in our experience this is caused by third-party extensions. Disable all extensions and then repeat the validation.

    Issue not solved?

    Gallery sliders have a wrong height on mobile devices

    Description

    In Shopware 6.3.2.1 the gallery slider on the product page has an incorrect height in the smartphone viewport. This creates an unnecessary blank space between the slider and the price.

    Solution

    Note: We can no longer reproduce the error in newer Shopware versions, please update Shopware to a current version.

    Issue not solved?

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    ThemeWare® update not available

    ThemeWare® update released but not available

    No ThemeWare® update is available in your administration, although a new version of ThemeWare® is already listed in the Shopware Store or in our Service Portal.

    This "issue" can have various causes:

    The lack of an update option for extensions or themes may simply be due to time constraints. It can take a while until an update is available in your system.

    Or the subscription for your theme – in the case of a purchased version of ThemeWare® – has expired.

    However, it can also be due to an outdated Shopware version. If an extension or theme is not compatible with your Shopware version, you will not receive further updates until you have updated Shopware.

    In addition, there are cases where the Shopware account is not or no longer connected to the shop. In this case, the shop no longer receives information about available updates.

    Due to the options mentioned above, there is no definite solution but several possible solutions.

    Configuration required. Please fill in data in all elements.

    When saving your Shopping Experience, you receive the error message "Configuration required. Please fill in data in all elements.".

    This is Shopware's way of indicating that you have not completely filled in all the mandatory fields of a CMS element.

    Fill all mandatory fields of your newly added CMS elements. These are often image fields.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Parse error: failed at $...

    You get the error message Unable to compile the theme "TcinnThemeWare...". parse error: failed at $...

    Crucial here is the note "parse error: failed at $...". This means that a wrong value was entered in a configuration field and in which configuration field this is the case respectively the technical name of the field: $...

    If the error message says Unable to compile the theme "TcinnThemeWareBath". parse error: failed at $sw-font-family-base: ‚Open Sans', sans-serif; (stdin) on line 11, at column 1, for example, the theme cannot be compiled or even saved due to an error in the $sw-font-family-base configuration field.

    Just change the corresponding configuration field.

    If you don't know which configuration field you are dealing with, just visit the ThemeWare® Config Finder and search there for the technical name

    Some blocks were not configured sufficiently

    When saving your Shopping Experience, you receive the error message "Some blocks were not configured sufficiently." or "Errors occurred. Please check the error list in the editor.".

    This is Shopware's way of indicating that you have not completely filled in all the mandatory fields of a CMS element.

    Fill all mandatory fields of your newly added CMS elements. These are often image fields or missing products in product sliders.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Unable to compile theme

    You get the error message Unable to compile the theme "TcinnThemeWare..." in the theme configuration.

    Please take a look at the following article:

    Description

    Solution

    Unable to compile theme
  • Wait a few hours. It may take a while for an update to appear in your system.

  • Check if you have a active subscription for your theme and renew it if necessary.

    • Note: Refers to the purchase version of ThemeWare®. The rental version always has a valid subscription.

  • Reconnect your Shopware account

    1. Log out of your Shopware account in the administration ("My extensions" => "Shopware Account").

    2. Clear the Shopware cache

    3. Log out of the administration

    4. Log back into your administration

  • Please update your Shopware installation to a more recent or the most recent Shopware version. (Newer releases may only be available for a more recent Shopware version).

    • Note: Please check first whether the current ThemeWare® version is compatible with the newest Shopware version:

    • Tip: Please note our update instructions for Shopware updates:

  • If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Description

    Note: This article only refers to the case that the update option is not displayed in the Extension Management!

    If the update does not work via the Extension Management, please refer to the article ThemeWare® cannot be updated.

    Cause

    Solutions

    Issue not solved?

    sw-font-family-base
    (without the "$").

    After you have adjusted the field, the theme or the duplicate can be saved and compiled again.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Description

    Cause

    Example:

    Note: If the error is not "parse error: failed at $..." but "Undefined variable $..." please have a look at this article: Undefined variable $...

    Solution

    Issue not solved?

    Description

    Cause

    Solution

    Tip: ThemeWare® shows you mandatory fields with a small blue asterisk. Unfortunately, Shopware itself currently does not have this feature.

    Issue not solved?

    Description

    Cause

    Solution

    **Tip: ThemeWare® shows you mandatory fields with a small blue asterisk. Unfortunately, Shopware itself currently does not have this feature.

    Issue not solved?

    SCSS Value "..." is not valid for type "color"

    Description

    You will receive the following error message when validating the theme configuration SCSS Value "..." is not valid for type "color".

    Examples:

    • SCSS Value "#9fa5ab;" is not valid for type "color"

    • SCSS Value "none" is not valid for type "color"

    • SCSS Value 'color' cannot be 'none'

    This error message is caused by improved validation of the theme configuration in Shopware 6.7 and indicates that you have filled in a colour configuration field incorrectly.

    There are two possibilities for this error:

    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.

    Why hasn't this error been noticed before?

    You may not have noticed this error in Shopware 6.6. However, with Shopware 6.7, the validation of the theme configuration has been significantly improved so that even minor typos are now reliably detected.

    You can find out how to correct invalid configuration fields in the following article:


    You can find more information about this validation error in the following article:

    Unable to find the theme

    Description

    Note: The issue is extremely rare. There is still too little information on this.

    Theme cannot be saved

    The theme cannot be saved – for example, after a Shopware update – so your changes will not be applied.

    The cause is stated in the accompanying error message. Usually, you have configured a configuration field incorrectly.

    Potential error messages:

    Unable to deactivate or uninstall theme

    You get the following error message during a Shopware update or when deactivating or uninstalling a theme:

    Unable to deactivate or uninstall theme "{themeName}". Please remove the following theme assignments: {assignments}.

    As the error message says, a theme must no longer be assigned to a sales channel so that it can be deactivated or uninstalled.

    With this message, Shopware asks you to remove the assignment of a theme (see {themeName}) from the sales channel (see {assignments}).

    In this case, simply assign the Shopware Standard Theme to the corresponding sales channel.

    Description

    Cause

    Solution

    Note: For information on how to assign the Shopware Standard Theme to a Sales Channel, see the following guide: Assign Shopware default theme

    Cause

    Solution

    Further information

    Fixing invalid configuration fields
    Invalid configuration

    Now log in your Shopware account in the administration again ("My extensions" => "Shopware Account").

    Shopware Compatibility
    Shopware Updates and ThemeWare®
    $color2: 0 is not a color
  • Error: argument '$color'

  • Parse error: failed at $...

  • SCSS Value "..." is not valid for type "color"

  • All you need to do is correct the relevant configuration field. The error message may indicate which configuration field is affected.

    You can alternatively validate your configuration:

    Why hasn't this error been noticed before?

    You may not have noticed this error in Shopware 6.6. However, with Shopware 6.7, the validation of the theme configuration has been significantly improved so that even minor typos are now reliably detected.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Description

    Cause

    Invalid configuration
    $color: 0 is not a color

    Further causes

    Another type of incorrect configuration is an incorrectly written or incorrectly used variable. This usually results in the following error message:

    Solution

    Issue not solved?

    Validate the theme configuration

    Header overlays the Shopping Experience on the home page

    Description

    The header overlays the Shopping Experience on the home page / the Shopping Experience is overlaid by the header.

    Cause

    The fact that the header overlays the Shopping Experience on the home page is not a representation error but a configurable effect of ThemeWare® in order to enable a certain look in different themes such as ThemeWare® Outdoor, ThemeWare® Exquisite or ThemeWare® Lights.

    You are probably using one of these themes, because the ThemeWare® Shopping Experience Header is already configured in them.

    Solution

    You can find out how to use or deactivate the header in the article Configuring the Shopping Experiences Header.

    Issue not solved?

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Error 500 / Themes cannot be saved

    Description

    Either the error massage "Error 500" occurs in the Theme Management and/or the theme cannot be saved.

    Cause

    Typically, this error means that the server is not providing enough resources. This does not mean that the server is generally too weak, it is more of a configuration issue.

    In most cases, you will find the specific cause in the PHP error log on your server. This does not mean the log within Shopware. If you do not know how to check the PHP error log, your hoster will certainly be happy to help you.

    In the PHP error log you will probably find references to the PHP settings memory_limit or max_execution_time.

    Solution

    Increase the memory_limit and/or the max_execution_time to the recommended values (or higher):

    • memory_limit: min. 512 MB

    • max_execution_time: min. 60 seconds

    In case you do not know how to change the value, your hoster will certainly be happy to help you.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    In addition, server performance can also be a problem when saving. This manifests itself in the following error:
    • Error 500 / Themes cannot be saved

    Undefined variable $...
    Error 400 / Theme cannot be saved

    Important: Even if your hosting (especially shared hosting) indicates a sufficient memory limit, it is not automatically for sure that you will receive that amount. Contact your hoster or agency to have it checked.

    Issue not solved?

    Unable to compile the theme...

    Description

    You get the error message Unable to compile the theme "TcinnThemeWare..." in the theme configuration.

    Cause

    There are several possibilities here, because this error can be caused by an unknown variable in a configuration field or by an incorrectly filled configuration field.

    • Unable to compile the theme "TcinnThemeWare...". Undefined variable $...

    • Unable to compile the theme "TcinnThemeWare...". parse error: failed at $...

    In addition, there are new error messages due to the new validation of the theme configuration from Shopware 6.6.9:

    • Unable to compile the theme "TcinnThemeWare...". Error: argument `$color` of `red($color)` must be a color

    • Unable to compile the theme "TcinnThemeWare...". $color: 0 is not a color

    • Unable to compile the theme "TcinnThemeWare...". $color2: 0 is not a color

    The part directly after the message Unable to compile the theme "..." is decisive. It says Undefined variable $... or parse error: failed at $... or a reference to the variable $color or $color2.

    Error compiling theme

    Description

    You get the error message Error compiling theme in the theme configuration.

    Solution

    If you click on "Show full error" it says "Unable to compile the theme...". Please have a look at the following article:

    Unable to compile the theme...

    Solution

    Unable to compile the theme "TcinnThemeWare...". Undefined variable $...

    Unable to compile the theme "TcinnThemeWare...". parse error: failed at $...

    Unable to compile the theme "TcinnThemeWare...". Error: argument `$color` of `red($color)` must be a color

    Unable to compile the theme "TcinnThemeWare...". $color: 0 is not a color

    Unable to compile the theme "TcinnThemeWare...". $color2: 0 is not a color

    Undefined variable $...
    Parse error: failed at $...
    Error: argument '$color'
    $color: 0 is not a color
    $color2: 0 is not a color

    Representation errors with a theme duplicate after an update

    After a theme update, representation errors soccasionally occurred in the storefront in a theme duplicate.

    If representation errors only occurred in a theme duplicate, a bug in Shopware was usually the cause.

    You can find more information in the article .

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Description

    Cause

    Hinweis: This bug was fixed by Shopware with version 6.4.8.0.

    Solution

    Issue not solved?

    New configuration fields are missing in a theme duplicate after update

    ThemeWare® cannot be updated

    Description

    In some rare cases it might happen that an update is available in the extension administration, but it cannot be executed.

    Note: This article only refers to the case that an update is listed in the Extension Management, but the update does not work.

    In case the update option is missing in the Extension Management, please look at the article .

    Cause

    Unfortunately, there is no definite solution so far, as the problem can have various causes.

    Solutions

    There are currently several possible workarounds:

    1) Check the PHP memory limit

    In our experience, an insufficient PHP memory_limit is often the cause of problems with updates of extensions (plugins, apps or themes).

    Check and if necessary increase the PHP memory_limit to the value recommended by Shopware of "512 MB or higher".

    If you do not know how to change the value, your hoster will certainly be happy to help you.

    Important: Even if your hosting (especially shared hosting) indicates a sufficient memory limit, it is not automatically guaranteed you will receive that amount. Contact your hoster or agency to have it checked.

    2) Deactivate theme

    It is always a good idea to deactivate (not uninstall!) an extension (plugin or app) or theme before updating. This often helps with update problems.

    1. Instructions:

    2. Instructions:

    3. Instructions:

    In some rare cases, the update with step 1 and 2 still does not work. There might be e.g. a problem with file permissions. In most of such cases the only thing that helps is a reinstallation.

    1. Instructions:

    2. Instructions:

    3. Instructions:

    In addition to the above options, a manual theme update via the Shopware 6 Extension Management would also be an option.

    • Instructions:

    You can also upload the ThemeWare® zip file to your server manually via FTP instead of using the Extension Management. Take particular care that the file permissions of the source files do not get messed up.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Simplified representation of the theme configuration

    Description

    The improved presentation of the theme configuration does not appear in a duplicate theme.

    Important: For technical reasons, the improved presentation of the theme configuration is currently only available in the ThemeWare® Pro Edition!

    Cause

    To ensure that the improved presentation of the theme configuration and the useful links of ThemeWare® do not affect other themes, it is necessary for us to restrict them to ThemeWare®. This is currently only possible by referring to the theme name.

    If your theme duplicate does not contain the word "ThemeWare" in its name, the improved presentation of the theme configuration will not be applied.

    Solution

    Rename your theme duplicate and add the word "ThemeWare" to benefit from the improved presentation of the theme configuration.

    Note: To learn how to rename a ThemeWare® duplicate, look at the article .

    Screenshots

    ThemeWare® Pro Edition (improved presentation)
    ThemeWare® Cloud Edition (default presentation)

    Issue not solved?

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    3) Reinstall theme

    Note: The theme configuration is currently kept even during the uninstall process unless you select the option "Remove all app data permanently". (Stand: Shopware 6.4.11.0)

    Important: Please save your theme configuration first. Please find the instruction for this in the article .

    Solutions (for experienced users)

    Update theme manually

    Attention: As incompatibilities may occur, it is essential to check the Shopware compatibility of ThemeWare®. We therefore only recommend this method to experienced users!

    Update theme via FTP

    Attention: As incompatibilities may occur, it is essential to check the Shopware compatibility of ThemeWare®. We therefore only recommend this method to experienced users!

    Screenshots

    Issue not solved?

    Deactivating ThemeWare®
    Updating ThemeWare®
    Activating ThemeWare®
    Uninstalling ThemeWare®
    Updating ThemeWare®
    Installing ThemeWare®
    Updating ThemeWare® manually
    ThemeWare® update not available
    ThemeWare® maunell updaten
    Renaming a ThemeWare® duplicate
    Exporting and importing the ThemeWare® configuration

    Error 400 / Theme cannot be saved

    Description

    When saving the theme configuration, the error message "Error 400" or "Error: Request failed with status code 400" is displayed and the theme has not been saved.

    Error: Request failed with status code 400

    Clicking on the button "Show full error" opens a pop-up with the message "Unable to compile the theme "TcinnThemeWare...". Undefined variable $...".

    Unable to compile theme

    Cause

    The message "Undefined variable $..." refers to a theme variable that is used in a configuration field. This is basically possible, but is unfortunately subject to a restriction.

    Variables must be initialised before they can be used in another configuration field. This is only the case if the variable has already been defined before the intended configuration field.

    The problem affects all configuration fields, but mainly occurs in Shopware standard configuration fields and theme duplicates. (Problematic configuration fields are indicated with corresponding information in their help texts).

    If you currently entered a variable in a configuration field, reload the theme configuration and change the corresponding configuration field back to an appropriate HEX or RGB value.

    If you do not know which configuration field this is, just visit the ThemeWare® Config Finder and search there for the technical name from the error message (e.g. $twt-color-brand-primary-light) without the dollar sign "$".

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Preview images in the Shopping Experience editor show placeholder images

    Instead of the selected images, the placeholder images are displayed. Unfortunately, this affects all CMS elements, including those from ThemeWare®. The correct images are nevertheless displayed in the Storefront.

    Unfortunately, there was a bug in Shopware 6.4.14 in the Shopping Experience editor regarding the preview images of CMS elements. This was reported to Shopware and fixed with version 6.4.15.

    Just update Shopware to version 6.4.15.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Solution

    Issue not solved?

    Description

    Cause

    Solution

    Note: Unfortunately, there are still scenarios in which the preview images are not always displayed correctly. If one case is solved, there will be a problem in another case. As long as the images are displayed correctly in the storefront, you will have to live with it for the time being.

    Issue not solved?

    New configuration fields are missing in a theme duplicate after update

    For a while, new configuration fields of themes were not applied to theme duplicates (child themes) during a theme update.

    Please update Shopware and ThemeWare® to the latest version.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Description

    Note: This bug was fixed by Shopware with version 6.4.8.0.

    Solution

    Issue not solved?

    Sticky top navigation does not work

    The Shopping Experience layout has been assigned but the CMS blocks are not displayed in the storefront.

    The sticky top navigation and the Shopping Experience Header from ThemeWare® are displayed and positioned using JavaScript.

    If the sticky top navigation is not displayed, there is a 99.9% chance that you will find one or more error messages in the browser DevTools relating to JavaScript errors.

    JavaScript errors caused by third-party extensions can affect ThemeWare® JavaScript features. In this case, the sticky top navigation is obviously affected.

    Deactivate (not uninstall!) all extensions used. If the problem no longer exists after deactivating all extensions, the issue is probably due to an extension.

    You can find more information in the article .

    Shipping costs pop-up is displayed without content

    The pop-up or modal for "Shipping Costs" (e.g. on the product page) opens but remains empty.

    This is not a theme "problem" or "bug" but a missing or incomplete Shopware configuration.

    More information and instructions on how to solve this "issue" can be found in the following article .

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Description

    Basic information

    Cause

    Solution

    Examining extensions or plugins

    Description

    Cause

    Solution

    Issue not solved?

    Pop-up (e.g. privacy) is displayed without content
    ThemeWare® Debugging | Shopware 6ThemeWare®

    Undefined variable $...

    Description

    You get the error message Unable to compile the theme "...". Undefined variable $....

    Cause

    Crucial here is the note "Undefined variable $...". This means that an unknown variable was entered in a configuration field and in which configuration field this is the case respectively what the technical name of the field is: $...

    Example:

    If the error message says Unable to compile the theme "TcinnThemeWareModern". Undefined variable $twt-color-brand-primary-light: line: 12, column 1, for example, the theme cannot be compiled or even saved due to an error in the $twt-color-brand-primary-light configuration field.

    Note: If the error is not "Undefined variable $..." but "parse error: failed at $..." please have a look at this article:

    Solution

    Just change the corresponding configuration field.

    If you don't know which configuration field you are dealing with, just visit the ThemeWare® Config Finder and search there for the technical name twt-color-brand-primary-light (without the "$").

    After you have adjusted the field, the theme or the duplicate can be saved and compiled again.

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®
    ThemeWare® Debugging | Shopware 6ThemeWare®

    Tip: Often this error occurs when variables are used in configuration fields, but the variables have not yet been initialized at this point. Then just use the RGBA or HEX value of a color instead of the variable.

    Issue not solved?

    ThemeWare® Debugging | Shopware 6ThemeWare®
    Parse error: failed at $...
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    ThemeWare® Config Finder – find any Shopware setting in secondsThemeWare®
    ThemeWare® Config Finder
    ThemeWare® Config Finder – find any Shopware setting in secondsThemeWare®
    ThemeWare® Config Finder
    ThemeWare® Config Finder – find any Shopware setting in secondsThemeWare®
    ThemeWare® Config Finder
    Logo
    Logo
    Logo
    Shopware 6 - Tutorials & FAQs - Why do we use Github Issues?issues.shopware.com
    NEXT-22730 | CMS element data resolving mismatch
    Shopware ChangelogShopware
    Changelog | Shopware 6.4.15.0
    Logo
    Logo

    Privacy pop-up is displayed without content

    The pop-up or modal for " Privacy" (e.g. in the footer newsletter) opens but remains empty.

    This is not a theme "problem" or "bug" but a missing or incomplete Shopware configuration.

    More information and instructions on how to solve this "issue" can be found in the following article .

    If you could not solve the problem, simply start the ThemeWare® Debugging. You can open a support ticket in case you are not able to solve the problem yourself:

    Description

    Cause

    Solution

    Issue not solved?

    ThemeWare® Debugging | Shopware 6ThemeWare®
    Pop-up (e.g. privacy) is displayed without content

    Saving the theme configuration takes a very long time

    Saving the theme configuration takes several minutes.

    When saving the theme configuration, the entire storefront is being compiled in the background. This means that the entire JS and CSS code of Shopware and all extensions (plugins, apps and themes) will be rebuilt.

    This can take 1-2 minutes depending on the theme, especially if a theme offers many settings, such as ThemeWare®.

    This process is mostly RAM and CPU dependent. Check if your server has sufficient resources and PHP is allocated these resources.

    Description

    Cause

    Solution

    Logo