All pages
Powered by GitBook
1 of 4

Loading...

Loading...

Loading...

Loading...

ThemeWare® Tools

With ThemeWare® you benefit from free access to the popular ThemeWare® Utilities. These helpful tools and extras support you significantly in the design and optimization of your shop.

The ThemeWare® tools include useful online wizards and free extensions.

Free online tools:

  • ThemeWare® Config Finder

Free extensions:

In this section of the ThemeWare® Knowledge Base you will find all information about these extensions. If you are looking for specific tutorials, please take a look at the "Tutorials" section.


Use the following link to get free access to the ThemeWare® theme utilities for your theme. These will be sent to you immediately by e-mail:

ThemeWare® Customizing App (Cloud)

In this article you will learn all about the free "ThemeWare® Customizing App".

Individual customizations have to be implemented in Shopware 6 with an own theme or an extension (plugin or app).

For the integration of individual customizations you may use an extension from the or our free "ThemeWare® Customizing App" (an extension based on the app system of Shopware 6).


You can find the download link for the free "Customizing app" via the ThemeWare® Utilities:


The app has to be uploaded using the administration of Shopware via "Extensions" => "My extensions" and the button "Upload extension".

Install and activate the app after that.

It can happen that the error "Undefined variable $twt-color-brand-secondary-light" appears during activation. However, the app is still activated.

Unable to compile the theme "Storefront". Undefined variable $twt-color-brand-secondary-light...

After activation, recompile your ThemeWare® theme once (just save the theme configuration unchanged, for example) and clear the Shopware cache.

Please find more information regarding the manual installation of extensions in the article:

If the extension has been successfully installed, example implementations (a JavaScript "test alert" and a "test banner") appear in the Storefront.

ThemeWare® Customizing App

From version 4.0, you can activate or deactivate the example implementations (e.g. the "test banner") in the app settings.


Using the "ThemeWare® Customizing App", it is possible to deposit individual customizations. In this context, the following folders and files are relevant

  • File "base.scss":

    • Basis for all customizations with CSS/SCSS

    • Folder: Resources/app/storefront/src/scss

    • Note: The file contains sample customizations which can be edited or deleted.

  • File "base.html.twig":

    • Example for template customization with Twig/HTML

    • Folder: Resources/views/storefront

  • File "custom.plugin.js":

    • Example of a JS plugin (imported via the file Resources/app/storefront/src/main.js)

    • Folder: Resources/app/storefront/src/js

  • Assets

    • Folder: Resources/public


As the app is free of charge and not available via the Shopware Store, there is currently no automatic update option.

You can always find the download link for the latest version via the ThemeWare® Utilities. If necessary, just register again:

Deactivate the app before you perform a Shopware update. You can find information on how to update your app manually below:

As all changes are overwritten on file level when updating extensions, it is important to backup the folder custom/apps/TcinnCustomizingApp/src before updating and upload it again after the update.

Below you will find notes on manual update options for the latest Shopware 6 major releases:

The customizing app for Shopware 6.6 is already compatible with Shopware 6.7.

The only change that needs to be made is to the twig block for our example customization, but you have probably already removed this block:

For more information about the extensive changes to the storefront in Shopware 6.7, please visit the ThemeWare® Service Portal:

To make the "Customizing App" compatible for Shopware 6.6, you need to make the following changes:

If you have not already done so for Shopware 6.5, please update the file "_messagebox.scss":

In addition, the integration of JavaScript plugins into the storefront has been changed with Shopware 6.6. Please delete all scripts in the folderResources\app\storefront\dist\storefront\js and rebuild the storefront once (e.g. with build-storefront.sh).

For more information on the extensive changes to the storefront in Shopware 6.6, please visit the Shopware Blog:

To make the customizing plugin basically compatible for Shopware 6.5, it is sufficient to modify the required Shopware version in the "_messagebox.scss" file as follows:

This makes the extension compatible with Shopware 6.5 and it does not need to be updated.

State: Shopware 6.6.0

Note: Please use the "ThemeWare® Customizing Plugin" in Shopware 6 (self-managed).

Download

Important: Please note that we offer the "ThemeWare® Customizing App" free of charge and cannot provide support for the App or individual customizations.

Installation

Shopware Community Store
base.html.twig
{% block base_header %}

>>
{% block base_body_inner %}
_messagebox.scss
color: color-yiq($twt-color-brand-secondary-light);

>>
color: color-contrast($twt-color-brand-secondary-light);
_messagebox.scss
color: color-yiq($twt-color-brand-secondary-light);

>>
color: color-contrast($twt-color-brand-secondary-light);

Activate/deactivate example implementations

Structure and feature

Note: You can find example customizations in "base.scss", "base.html.twig" and "custom.plugin.js". Adjust the content of the files to your requirements.

Update

Manual update

Note: You can find the latest version in the .

Shopware 6.7

Note: Whether your existing version can continue to be used with Shopware 6.7 depends primarily on your individual customizations. We recommend testing this first in a test or staging environment.

Note: Please note that your individual customizations may also need to be made compatible.

Shopware 6.6

SCSS

JavaScript

Note: Please note that your individual customizations may also need to be made compatible.

Shopware 6.5

Install extensions manually

Download

ThemeWare® Debugging
ThemeWare® Search
ThemeWare® Feature request
24/7 AI Support Assistent
ThemeWare® Customizing Plugin
ThemeWare® Customizing App (Cloud)
ThemeWare® Shopping Experiences Import (Plugin)

ThemeWare® Customizing Plugin

In this article you will find out everything regarding the free "ThemeWare® Customizing Plugin".

Individual customizations have to be implemented in Shopware 6 with an own theme or an extension (plugin or app).

For the integration of individual customizations you may use an extension from the Shopware Community Store or our free "ThemeWare® Customizing Plugin" (an extension based on the plug-in system of Shopware 6).

Note: Please use the "" in the Shopware 6 Cloud.


Download

You can find the download link for the free "Customizing plugin" via the ThemeWare® Utilities:

Important: Please note that we offer the "ThemeWare® Customizing Plugin" free of charge and cannot provide support for the plugin or individual customizations.


Installation

The extension has to be uploaded using the administration of Shopware via "Extensions" => "My extensions" and the button "Upload extension".

Then install and activate the extension.

After activation, recompile your ThemeWare® theme once (just save the theme configuration unchanged, for example) and clear the Shopware cache.

Please find more information regarding the manual installation of extensions in the article:

If the extension has been successfully installed, example implementations (a "test banner") appear in the Storefront:

From version 5.0, you can activate or deactivate the example implementations (e.g. the "test banner") in the plugin settings.


The "ThemeWare® Customizing Plugin" offers the possibility to deposit individual customizations. The following folders and files are relevant:

  • File "base.scss":

    • Basis for all customizations with CSS/SCSS

    • Folder: src/Resources/app/storefront/src/scss


As the plugin is free of charge and not available via the Shopware Store, there is currently no automatic update option.

You can always find the download link for the latest version via the ThemeWare® Utilities. If necessary, just register again:

Deactivate the plugin before you perform a Shopware update. You can find information on how to update your plugin manually below:

As all changes are overwritten on file level when updating extensions, it is important to backup the folder custom/plugins/TcinnCustomizing/src before updating and upload it again after the update.

Below you will find notes on manual update options for the latest Shopware 6 major releases:

To make the "Customizing Plugin" compatible with Shopware 6.7, it is sufficient to modify the required Shopware version in the file "composer.json" as follows:

This makes the extension compatible with Shopware 6.7 and it does not need to be updated.

In addition, the twig block for our example customization changes, but you have probably already removed this block:

For more information about the extensive changes to the storefront in Shopware 6.7, please visit the ThemeWare® Service Portal:

To make the "Customizing Plugin" compatible with Shopware 6.6, it is sufficient to modify the required Shopware version in the file "composer.json" as follows:

This makes the extension compatible with Shopware 6.6 and it does not need to be updated.

For more information on the extensive changes to the storefront in Shopware 6.6, please visit the Shopware Blog:

To make the customizing plugin basically compatible with Shopware 6.5, it is sufficient to modify the required Shopware version in the file "composer.json" as follows:

This makes the extension compatible with Shopware 6.5 and it does not need to be updated.

Please note that your individual customizations may also need to be made compatible. For more information on the extensive changes to the storefront in Shopware 6.5, please visit the Shopware Blog:

To make the customizing plugin basically compatible with Shopware 6.4, it is sufficient to rename the file "main.scss" to "base.scss" and modify the required Shopware version in the file "composer.json" as follows:

This will make the extension compatible with Shopware 6.4 and does not need to be updated.

Please note that your individual customizations may also need to be made compatible. The most important change in Shopware 6.4 is the retrieval of theme and Shopware variables:

State: Shopware 6.7.0

Note: The file contains sample customizations which can be edited or deleted.

  • Note: The file contains a sample JS plugin that can be edited or deleted.

  • ThemeWare® Utilities

    Note: The file contains sample customizations which can be edited or deleted.

  • File "base.html.twig":

    • Example of template customization with Twig/HTML

    • Folder: src/Resources/views/storefront

    • Note: The file contains sample customizations which can be edited or deleted.

  • Assets

    • Folder: src/Resources/public

  • composer.json
    "require": {
     "shopware/core": "6.6.*"
    },
    
    "require": {
     "shopware/core": "6.7.*"
    },
    base.html.twig
    {% block base_header %}
    
    >>
    {% block base_body_inner %}
    composer.json
    "require": {
     "shopware/core": "6.5.*"
    },
    
    "require": {
     "shopware/core": "6.6.*"
    },
    composer.json
    "require": {
     "shopware/core": "6.4.*"
    },
    
    "require": {
     "shopware/core": "6.5.*"
    },
    composer.json
    "require": {
     "shopware/core": "6.3.*"
    },
    
    "require": {
     "shopware/core": "6.4.*"
    },
    shopware.theme["..."] => theme_config('..')
    
    >>
    shopware.config.core... => config('core...')

    Activate/deactivate example implementations

    Structure and function

    Update

    Important: Please note that we offer the "ThemeWare® Customizing Plugin" free of charge and cannot provide support for the plugin or individual customizations.

    Manual update

    Note: You can find the latest version in the ThemeWare® Utilities.

    Shopware 6.7

    Note: Whether your existing version can continue to be used with Shopware 6.7 depends primarily on your individual customizations. We recommend testing this first in a test or staging environment.

    Note: Please note that your individual customizations may also need to be made compatible.

    Shopware 6.6

    Note: Please note that your individual customizations may also need to be made compatible.

    Shopware 6.5

    Shopware 6.4

    Install extensions manually
    ThemeWare® Customizing App
    ThemeWare® Customizing Plugin

    ThemeWare® Shopping Experiences Import (Plugin)

    In this article you will learn everything about the free "ThemeWare® Shopping Experience Import" plugin.

    To make it as easy as possible for you to install your theme's Shopping Experience, we have developed a free 1-click import plugin for you.

    The extension is based on the Shopware plugin system. This means that it was developed for use in self-hosted shops. Use in the Shopware Cloud is not possible.

    Note: For Shopware 6 Cloud users, we recommend the step-by-step instructions in PDF format from our .

    We recommend using the plugin – if possible – not in productive environments and before the launch of your shop.


    Download

    You can find the download link for the free "ThemeWare® Shopping Experience Import" plugin via the ThemeWare® Utilities:

    Last updated: May 2026 (v2.0.1)


    The zip file of the extension must be uploaded via the Shopware administration under "Extensions" (1) => "My extensions" (2) using the "Upload extension" button (3).

    Install (4) and then activate (5) the extension.

    When the plugin is activated, the available Shopping Experiences and the necessary images are imported.

    You can find more information on the manual installation of extensions in the article:

    Note:

    The sample images are imported into a subfolder ThemeWare® <Theme name> within the default "CMS Media" folder. If you receive an error message during installation with the note "No default folder for entity “cms_page” found", this folder is missing from your administration.

    Please create the appropriate folder so that the installation works:


    If the extension has been successfully installed and activated, you will find the corresponding Shopping Experience(s) in the Shopping Experience management of your shop.

    You can find the Shopping Experience management in the Shopware administration under "Content" (1) => "Shopping Experiences" (2).

    The layouts are locked and cannot be modified directly. First, duplicate (3, 4) the relevant experience world layout, then use the duplicate to make your adjustments.

    This ensures that your customised layout is not accidentally uninstalled and is update-proof.


    The extension automatically imports the necessary preview images for the corresponding Shopping Experiences when it is activated. You can find the preview images in the media management ("Content" => "Media") in CMS Media > ThemeWare® <Theme name>.

    The ThemeWare® Shopping Experiences contain various product sliders. If you use the demo data from Shopware, the product sliders are automatically filled with products from the demo data. If you are not using the demo data, the product sliders are empty and therefore "unconfigured". In this case, just add products from your shop.


    When activating the plugin:

    • the Shopping Experience templates of this theme are imported into your shop

    • the corresponding images are placed in a dedicated media folder ThemeWare® <Theme name> (inside "CMS Media")

    • the imported Shopping Experiences are locked against accidental modification – see the note above on duplicating

    You can deactivate and reactivate the plugin at any time. If the demo data is still present, reactivating will simply update it.

    Deactivating the plugin does nothing to your data. Shopping Experiences, images and the media folder remain unchanged. Useful when you want to temporarily switch the plugin off without changing your shop content.

    When uninstalling, Shopware offers you two options:

    Default (checkbox "Permanently remove all app data" not ticked)

    • The Shopping Experience templates are removed – they are pure plugin content and would otherwise remain orphaned in the backend

    • Your duplicates of the Shopping Experience templates will be retained

    • Images are kept and can still be used by you

    With "Permanently remove all app data" ticked

    • The Shopping Experience templates are removed

    • Your duplicates of the Shopping Experience templates will be retained

    • The images are also removed – but only those you no longer use anywhere. Images you have used e.g. as a product image or in your own Shopping Experience are automatically preserved


    As the plugin is free of charge and not available via the Shopware Store, there is currently no automatic update option. Deactivate the plugin when you have set up your Shopping Experience – at the latest before you perform´a Shopware update.

    Note: You can always get the latest version via ThemeWare® Utilities.

    The media folder ThemeWare® <Theme name> is kept as long as it still contains images
    The media folder ThemeWare® <Theme name> is removed if empty

    Important: Please note that we offer the "ThemeWare® Shopping Experience Import" plugin free of charge and do not provide support for the plugin.

    Installation

    Important: Please note that the data is imported when the plugin is activated and may overwrite existing data (previous imports).

    Note: Installing the plugin only places it in your shop – no demo data is imported yet. Images and Shopping Experiences are only created on activation.

    Editing the Shopping Experience

    Important: Duplicate the Shopping Experience template

    Images & Products

    Tip: You also get PSD templates of the preview images with ThemeWare® Utilities Mail.

    Activating, deactivating and uninstalling

    Activating

    Deactivating

    Uninstalling

    Update

    Install extensions manually
    Create default folder for media
    ThemeWare® Utilities
    Extension management
    Shopping Experience management
    Request ThemeWare® Utilities for free | ThemeWare® Service PortalThemeWare®
    ThemeWare® Service Portal > ThemeWare® Utilities
    Request ThemeWare® Utilities for free | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    Request ThemeWare® Utilities for free | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    Request ThemeWare® Utilities for free | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    Request ThemeWare® Utilities for free | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    Request ThemeWare® Utilities for free | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    Logo
    Logo
    Logo
    Logo
    Logo
    Logo
    Shopware 6.7 – What You Need to Know | ThemeWare® Service PortalThemeWare®
    Shopware 6.7 – What You Need to Know | ThemeWare® Service PortalThemeWare®
    Logo
    Logo
    Shopware 6.5 – all about the major releaseShopware's Blog - Ecommerce News
    Shopware 6.5 – all about the brand new major release
    Shopware 6.6: A look ahead | ThemeWare® Service PortalThemeWare®
    Shopware 6.6: A look ahead | ThemeWare® Service PortalThemeWare®
    Logo
    Logo
    Logo