LogoLogo
SearchService PortalManualOthersDeutschRequest support
  • Welcome
  • Knowledge Base
    • Introduction
      • Testing ThemeWare®
      • Installing ThemeWare®
      • Activating ThemeWare®
      • Assigning ThemeWare®
      • ThemeWare® Utilities downloaden
      • Überblick Theme-Konfiguration
      • ThemeWare® bearbeiten
      • Themes kombinieren
      • Farben konfigurieren
      • Schriften konfigurieren
      • Logo einbinden
      • Logo konfigurieren
      • Text-Logo konfigurieren
      • Shop-Navigation konfigurieren
      • Texte im Theme bearbeiten
      • USP-Bar konfigurieren
      • Erlebniswelten verstehen
      • ThemeWare® Demoshops
      • Setting up the home page (ThemeWare® Shopping Experience)
      • Design der Kategorie-Seite anpassen
      • Shopseiten bearbeiten und anlegen
      • Service-Navigation konfigurieren
      • Footer-Navigation konfigurieren
      • Footer konfigurieren
      • Zahlungs- und Versandanbieter Logos
      • Mehrsprachigkeit mit ThemeWare®
      • Mehr als ein ThemeWare® Theme nutzen
      • ThemeWare® erwerben
      • Getting support
      • Updates and news
    • Tutorials
      • Administration
        • Testing ThemeWare®
        • Buying ThemeWare®
        • Renting ThemeWare®
        • Uploading ThemeWare®
        • Installing ThemeWare®
        • Activating ThemeWare®
        • Assigning ThemeWare®
        • Editing ThemeWare®
        • Resetting ThemeWare®
        • Rating ThemeWare®
        • Updating ThemeWare®
        • Cleaning up ThemeWare®
        • Deactivating ThemeWare®
        • Uninstalling ThemeWare®
        • Deleting ThemeWare®
        • Returning ThemeWare®
        • Determining the ThemeWare® version
        • Shopware Updates and ThemeWare®
      • Categories
        • Assign a category layout
        • Cooking pleasure & Provence (Demoshop)
        • Craft & Tradition (Demoshop)
        • Create a category
        • Create a category layout
        • Create a category layout with sidebar
        • Make product boxes more compact
        • Make product listings more compact
        • Mountain air & Adventure (Demoshop)
      • Configuration
        • Child theme
        • Color configuration field
        • Field types in the theme configuration
        • Font configuration field
        • Using SCSS functions in the configuration
        • Using theme variables in the configuration
        • ThemeWare® duplicates
        • Creating a ThemeWare® duplicate
        • Renaming a ThemeWare® duplicate
        • Orphaned configuration fields
      • Custom Fields
      • Debugging
        • Identifying the extension as the cause of the error
        • Debugging error messages
        • Narrowing down errors
        • Identifying the theme as the cause of error
        • Debug mode
      • Demoshops
        • Home page
        • Category "Mountain air & Adventure"
        • Category "Cooking pleasure & Provence"
        • Category "Craft & Tradition"
        • Configuration
      • Fonts
        • Embedding fonts locally
        • Embedding fonts locally using the ThemeWare® Customizing Plugin
        • Font configuration
        • Importing Google Fonts
      • Header
        • Configuring the Shopping Experiences Header
      • Individual customizations
        • Individual customizations by means of CSS
        • Individual customizations by means of SCSS
        • Individual template customizations (Twig, HTML)
        • Individual customizations with the ThemeWare® Customizing Plugin
        • Individual customizations with the ThemeWare® Customizing App (Cloud)
        • Embed custom JavaScript code
        • CSS hierarchy
        • Using Bootstrap in the Storefront
        • Show custom fields in the storefront
      • Landing pages
        • Create a landing page
        • Create a landing page layout
        • Assign a landing page layout
        • Create a home page
      • Miscellaneous
        • Clearing / warming up the Shopware cache
        • Clearing the browser cache
        • Compiling the theme
        • Refreshing the storefront
      • Product pages
        • Create a product layout
        • Create a product layout with sidebar
        • Assign a product layout
      • Shop pages
        • Creating a shop page layout
        • Linking shop pages in the storefront
        • Creating a contact page
        • Creating a GTC page
        • Creating a newsletter page
        • Creating a payment and shipping information page
        • Creating a privacy page
        • Creating a revocation notices page
        • Creating an imprint page
      • Shopping Experiences
        • ThemeWare® CMS styling for Shopping Experiences
        • ThemeWare® CSS classes for Shopping Experiences
        • Adjusting column spacings in CMS blocks
        • Adjusting gaps in CMS blocks
        • CSS classes for full-width sections
        • CSS spacing classes for Shopping Experiences
        • Designing headlines in CMS blocks
        • Designing Shopping Experiences with Bootstrap CSS classes
        • Designing Shopping Experiences with Bootstrap HTML code
        • Embellishing images in CMS blocks
        • Embellishing images in CMS blocks with hover effects
        • Embellishing Shopping Experiences with CSS animations
        • Hide CMS blocks on mobile devices
        • Mark CMS blocks as favourites to find them faster
        • Mark CMS elements as favourites to find them faster
        • Recreating category Shopping Experiences of the demoshops
        • Responsive Shopping Experiences
        • Responsive Shopping Experiences with Bootstrap
        • Show custom fields in Shopping Experiences
      • Shopware Account
        • Renew ThemeWare® Subscription
        • Switch to rental license
      • Shopware Store
        • Finding ThemeWare®
        • Testing ThemeWare®
        • Buying ThemeWare®
        • Renting ThemeWare®
        • Purchasing ThemeWare® after the trial period
        • Renting ThemeWare® after the trial month
      • Solving errors
        • Examining extensions or plugins
        • Examining individual customizations
        • Examining Shopware default theme
        • Performing a ThemeWare® Soft Reset
        • Fixing representation errors
        • Reinstalling ThemeWare®
        • Solving known errors by yourself easily
        • Update the shop
      • Texts: Edit and translate
    • Basic knowledge
      • Update guide
      • Color configuration
      • Font configuration
      • HTML code
      • Identifying the current ThemeWare® Version
      • Images
        • Display mode of images
        • Image sizes
      • Licences
      • Payment methods
      • Plugin Compatibility (HC-Architecture®)
      • Shipping methods
      • Shopping Experiences
        • CMS layout
        • CMS section
        • CMS block
        • CMS element
      • Shopware Compatibility
      • Snippets
      • Supported browsers
      • ThemeWare® data
    • Profi knowledge
      • The ultimate Professional Knowledge
      • Backup of the ThemeWare® configuration
      • Backing up and restoring the ThemeWare® configuration
      • Column CSS classes in ThemeWare® CMS elements
      • Deactivating ThemeWare® via the database
      • Debug mode
      • Editing the database with the Adminer
      • Establishing compatibility with ThemeWare® for Shopware 6
      • Expert mode
      • Expert settings in CMS elements
      • Expert settings in the theme configuration
      • Exporting and importing the ThemeWare® configuration
      • HTML Sanitizer
      • Installing ThemeWare® manually
      • Optimizing Shopping Experiences with Bootstrap CSS classes
      • Optimizing Shopping Experiences with Bootstrap HTML elements
      • Resetting the ThemeWare® configuration
      • SCSS
      • ThemeWare® in the database
      • ThemeWare® on the FTP server
      • Twig
      • Updating ThemeWare® manually
      • Uploading ThemeWare® via FTP
      • Using Bootstrap CSS classes
      • Using Bootstrap HTML code
    • Frequent questions
      • Frequently searched features in ThemeWare®
      • Can I extend the trial month?
      • Can I extend the trial period?
      • Do I have to purchase ThemeWare® again for another domain?
      • Do I have to purchase ThemeWare® again for another Sales Channel?
      • How can I change or translate a text (e.g. of widgets)?
      • How can I change the number of levels in the flyout?
      • How can I embed Google Fonts in a GDPR compliant manner locally?
      • How do I cancel a extension rent?
      • How can I customise snippets for individual Sales Channels?
      • How can I customise texts for individual Sales Channels?
      • How can I fix representation errors?
      • How can I hide CMS blocks on mobile devices?
      • How can I hide the product description in product boxes?
      • How can I make individual customisations?
      • How can I make the listing look more compact?
      • How can I make product boxes more compact?
      • How can I remove the border around a CMS block?
      • How can I remove the borders around CMS blocks?
      • How can I remove the spaces in the listing?
      • How can I use a different configuration for a Sales Channel?
      • How can I use an individual configuration for an additional Sales Channel?
      • How do I configure the autoplay in the image slider?
      • How do I use webfonts in a GDPR compliant manner?
      • How to delete licences correctly?
      • The subscription expires - what now?
      • What does "Already compatible" mean?
      • What does "Not compatible" mean?
      • What does "Now avaiable" mean?
      • What does "With new Shopware version" mean?
      • What does the "Extension Warning" window mean when opening my admin?
      • What image sizes should I use with ThemeWare®?
      • When does the trial month end?
      • When does the trial period end?
      • Why does the header overlay the Shopping Experience?
      • Why does the subscription have to be renewed for bought extensions?
      • Why is the new ThemeWare® version not available?
      • Why is ThemeWare® available several times in the Shopware store?
    • Common issues
      • Storefront
        • Branding is shown despite Licence Key
        • CMS blocks are not displayed in Shopping Experience
        • Gallery sliders have a wrong height on mobile devices
        • 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
      • Administration
        • Administration not accessible
        • Allowed memory size of ... bytes exhausted
        • Bad Request...
        • $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
        • 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
        • 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 $...
    • Tips and tricks
      • Image optimization
      • Logo design tips
      • Recommended Extensions or Plugins
      • Technical terms explained
      • The top 10 tips
      • Useful Links
      • Ideales Vorgehen bei der Konfiguration
      • Konfigurationsfelder schnell finden
      • Wie du jede Farbe im Theme Manager findest
    • Shopware
      • Getting Started
        • System Requirements
      • Migration
      • Configuration
        • Shopping Experiences
          • Inserting images into text fields
        • Themes
          • Assign Shopware default theme
        • Extensions
          • Activate extensions
          • Deactivate extensions
          • Install extensions
          • Install extensions manually
          • Purchase extensions
          • Rate extensions
          • Remove extensions
          • Rent extensions
          • Return extensions
          • Uninstall extensions
          • Update extensions
          • Update extensions manually
        • Sales channel
          • Maintenance mode
        • Settings
          • Caches & Indexes
      • Cloud
      • Shopware Extensions
      • Tutorials
      • Update Guides
      • Support
      • Shopware Account
        • Linking up the Shopware Account with the shop
        • Moving Licenses in the Shopware Account to a different Domain
        • Registering the Shopware Account in the administration
        • Rename shop domain
        • Setting up the shop in the Shopware Account
        • Transfer licenses
  • More knowledge
    • ThemeWare® Extras
    • ThemeWare® Tools
      • ThemeWare® Customizing Plugin
      • ThemeWare® Customizing App (Cloud)
      • ThemeWare® Shopping Experiences Import (Plugin)
    • Lexicon
    • Accessibility
    • SEO & Pagespeed
      • PageSpeed Insights
  • Others
    • About ThemeWare®
    • ThemeWare® Demoshops
    • ThemeWare® Manual
    • ThemeWare® Video Tutorial
    • ThemeWare® Utilities
    • 🇩🇪Deutsch
Powered by GitBook
LogoLogo

ThemeWare®

  • About ThemeWare®
  • ThemeWare® Demoshops
  • ThemeWare® Service Portal
  • ThemeWare® Utilities

Informations

  • Legal notice
  • Newsletter
  • Privacy
  • Support

© 2024 by ThemeWare® | Made with 💙 by TC-Innovations GmbH

On this page
  • Compatibility
  • Shopware Update
  • 1) Preparation
  • 2) Shopware Update
  • A. Already compatible
  • B. Now avaiable
  • C. With new Shopware version
  • D. Not compatible
  • Troubleshooting
  • Update guidelines 💡
  • Further information

Was this helpful?

  1. Knowledge Base
  2. Tutorials
  3. Administration

Shopware Updates and ThemeWare®

In this guide you will learn how to proceed if you need to update Shopware 6 together with ThemeWare® update.

We regularly release updates of ThemeWare®. So most of the ThemeWare® updates you do independently from Shopware updates.

But of course there are also cases where you want to perform a Shopware update. In these cases, it always makes sense to update extensions (plugins, apps or themes) before or after.

Note: For information on how to update ThemeWare®, see the article Updating ThemeWare®.

Whether you need to update extensions before or after the Shopware update depends on the compatibility of the extensions (plugins, apps or themes).

The type of Shopware release must also be taken into account here, as there are different types of Shopware releases:

Shopware versioning

  • Major-Release

    • Incompatible API changes are made (= breaking changes)

    • z.B. 6.5 > 6.6

  • Minor-Release

    • Functionality is added in a backward-compatible manner

    • z.B. 6.5.1 > 6.5.2

  • Patch-Release

    • Backward-compatible bug fixes are made

    • z.B. 6.5.1.1 > 6.5.1.2


Compatibility

Basically,ThemeWare® is always compatible with the latest Shopware version or will be released in a compatible version in the short term. Accordingly, there is always a suitable ThemeWare® version for older Shopware versions.

As we test ThemeWare® in every new Shopware release, it can happen – depending on how extensive the necessary adjustments are – that a ThemeWare® update is only released shortly after the Shopware update.

Major-Releases

However, it can happen that there is no ThemeWare® version (this applies to all extensions) that is compatible with both the old and the new Shopware version at the same time. This is always the case when Shopware makes so-called "breaking changes" that make compatibility with both versions impossible.

As you can see in the "Shopware versioning" above, "breaking changes" are mainly possible in major releases.

Note: More information about the topic "Shopware Compatibility" you will find in our article Shopware Compatibility.

Important: Please always use the update option of the extension management and do not install extensions manually to avoid installing an incompatible extension.


Shopware Update

The Shopware update wizard will inform you if there are incompatible extensions. Incompatible extensions must be deactivated before the Shopware update and should only be activated when a compatible version has been released.

Please find more information on the correct procedure in the following instructions.

Note: "Deactivating" extensions (plugins, apps or themes) does not delete any data. (Status: Shopware 6.6)

Tip: Most of this guide applies to all extensions (plugins, apps or themes), but to simplify matters we refer to ThemeWare®.

Step-by-step instructions:

Please find below a step-by-step guide for Shopware updates. Basically there are three possible cases:

These three cases are considered in the following instructions:


1) Preparation

We recommend that you wait a few days/weeks before updating Shopware - especially for major releases of the update.

Tip: Wait a few days/weeks for the Shopware update, especially for major Shopware releases.

Test each update in advance in a test system or a staging environment and check that everything works smoothly.

It is also essential to create a complete backup of your shop before the Shopware update.

Tip: Create a complete backup of your shop before the Shopware update and test the update in advance in a test or staging system.

Update ThemeWare® and all extensions (plugins, apps or themes) in your system to the latest versions.

Important: Update all extensions (plugins, apps or themes) in your system before every Shopware update.

Check whether there is already a compatible version for all extensions (plugins, apps or themes) or themes.

It is best to only perform out the Shopware update if you have ensured that all extensions used are installed in a compatible and error-free version.

If you want to perform the Shopware update even if not all extensions used are compatible, leave incompatible extensions deactivated until you have been able to install a compatible version.

Important: Deactivate all incompatible extensions before a Shopware update and activate them if you have been able to update them to a compatible version.


2) Shopware Update

There are three options for Shopware updates:

  • A. Already compatible

  • B. Now avaiable

  • C. With new Shopware version

  • D. Not compatible

A. Already compatible

ThemeWare® is already compatible with both the current and the new Shopware version:

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

  2. Optional: Then deactivate your ThemeWare® theme

    • Tip: Clear the entire Shopware cache once

  3. Optional: Perform a ThemeWare® update

  4. Perform the Shopware Update

    • Important: Only if really all extensions are "already compatible"!

  5. Optional: Activate ThemeWare® again

    • Tip: Clear the entire Shopware cache once

  6. Optional: Assign ThemeWare® to your sales channel to complete the process

  7. Clear the entire Shopware cache once and reload the administration

Note: If you were unable to update ThemeWare® to the latest version, take a look at the article ThemeWare® update not available.

B. Now avaiable

A compatible ThemeWare® version is available before the Shopware update:

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

  2. Then deactivate your ThemeWare® theme

    • Tip: Clear the entire Shopware cache once

  3. Perform the ThemeWare® update

  4. Now perform the Shopware update

    • Important: Only if really all extensions are "already compatible"!

  5. Activate ThemeWare® again

    • Tip: Clear the entire Shopware cache once

  6. Assign ThemeWare® to your sales channel to complete the process

  7. Clear the entire Shopware cache once and reload the administration

Note: If you were unable to update ThemeWare® to the latest version, take a look at the article ThemeWare® update not available.

C. With new Shopware version

A compatible ThemeWare® version is available after the Shopware update:

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

  2. Then deactivate your ThemeWare® theme

  3. Clear the entire Shopware cache once

  4. Perform the Shopware update

  5. Now perform the ThemeWare® update

  6. Activate ThemeWare® (in the compatible version) again

    • Tip: Clear the entire Shopware cache once

  7. Assign ThemeWare® to your sales channel to complete the process

  8. Clear the entire Shopware cache once and reload the administration

Attention: Do not activate an incompatible version of an extension in your Shopware shop!

In this scenario, the old ThemeWare® version is not compatible with the new Shopware version and the new ThemeWare® version is not compatible with the old Shopware version.

Note: If you were unable to update ThemeWare® to the latest version, take a look at the article ThemeWare® update not available.

D. Not compatible

A compatible ThemeWare® version for the new Shopware version is NOT yet available:

  • If there is no compatible version of ThemeWare® yet for the new Shopware release, wait with the Shopware update until this is the case.

  • If you still want to perform the Shopware update, leave ThemeWare® (or any incompatible extension) deactivated until you have been able to update to a compatible version.


Troubleshooting

We hope you have followed the hints regarding the creation of a backup and testing in a staging environment and you can restore your backup or perform a new test.

If the administration is not accessible due to an incompatible extension, deactivate the corresponding extension via the database (see Deactivating ThemeWare® via the database). The administration should then work again.


Update guidelines 💡

Always refer to our update guide when updating ThemeWare®:


Further information

  • FAQ: What does "Already compatible" mean?

  • FAQ: What does "Now avaiable" mean?

  • FAQ: What does "With new Shopware version" mean?

  • FAQ: What does "Not compatible" mean?

PreviousDetermining the ThemeWare® versionNextCategories

Last updated 4 months ago

Was this helpful?

Tip: You can find more information about possible incompatibilities or information about updates in the block in our Service Portal.

If the current version of ThemeWare® is compatible with both the current and the new Shopware version, you can easily update Shopware ().

If the current version of ThemeWare® is not compatible with the new Shopware version but there is a compatible ThemeWare® version for the current and the new Shopware version, first update ThemeWare® before updating Shopware ().

If the current version of ThemeWare® is not compatible with the new Shopware version but there is a compatible ThemeWare® version for the new Shopware version, deactivate ThemeWare®, update Shopware first and then ThemeWare® ().

If the current version of ThemeWare® is not compatible with the new Shopware version and there is currently no compatible ThemeWare® version, deactivate ThemeWare®, perform the Shopware update and reactivate ThemeWare® only after you have been able to update it ().

Tip: If you want to make sure that ThemeWare® is already compatible, you can check the store page of the corresponding extension in the which versions are currently supported.

ThemeWare® now is "already compartible" ()

Important: Make sure that your ThemeWare® version is compatible with the current Shopware version:

If this is not the case, deactivate the problematic extension and only activate it once you have been able to update the corresponding extension to a compatible version (see ).

News and announcements
Shopware Store
Shopware Compatibility
Update guide
A
B
C
D
A
Checking Compatibility
Already compatible
Now avaiable
With new Shopware version
Not compatible