The ThemeWare® rental version includes a free trial month. The rental can be cancelled at any time on a monthly basis.

At the end of the trial month, ThemeWare® is automatically extended at the prices stated at the time of booking.

The ThemeWare® Introduction is a written form of the popular ThemeWare® Video Tutorial. As we are currently revising the video tutorial, the introduction is not yet complete, but it is growing bit by bit. If an article is still missing or incomplete, please have a look at the ThemeWare® Video Tutorial.

ThemeWare® demoshops

The ThemeWare® demoshops present all ThemeWare® themes live and in colour.

Are there any differences to the freshly installed theme?

For technical reasons, themes do not install categories or Shopping Experiences. You can use the free demo data plugin from Shopware, for example, to import sample products and categories.

We also explain how to create categories and the Shopping Experience on the home page in the free ThemeWare® Video Tutorial and step-by-step PDF instructions.

Configuration

With ThemeWare® you benefit from extremely regular updates with new features and configurations. To avoid affecting the many ThemeWare® shops of our customers, new features and functions are of course deactivated when they are released. You can therefore decide for yourself whether and if so which new feature you want to use.

However, as we still want to present new features in our demoshops , the demoshops will differ slightly from the default configuration of our theme over time. But don't worry, the demoshops are based entirely on ThemeWare®, you can activate everything we show in the demoshops yourself with just a few clicks.

You can find all the information about our demoshops and configuration in the following article. However, we recommend that you complete the introduction first.

Welcome to the ThemeWare® Knowledge Base and thank you for choosing ThemeWare®!

The ThemeWare® documentation for Shopware 6 is based on 3 "pillars":

1. The Service Portal

   • The Service Portal is always the first place to go for all your ThemeWare® needs. It is your personal dashboard for ThemeWare®.

   • There you will always find all the relevant links and information about ThemeWare®, the ThemeWare® Video Tutorial, the ThemeWare® Utilities, the ThemeWare® Search, the ThemeWare® Config Finder, wizards, promotions, useful tools, feedback and contact forms and much more.

   • You can find the Service Portal here:

2. The ThemeWare® Knowledge Base

   • In the ThemeWare® Knowledge Base you will find the ThemeWare® Introduction, many guides and tutorials, the ThemeWare® Lexicon, answers to the most frequently asked questions, solutions to the most common issues, professional knowledge for agencies and freelancers and lots of useful information about Shopware 6.

3. The ThemeWare® Manual

   • In the ThemeWare® Manual you will find information about all the features and functions of ThemeWare®.

   • You can find the ThemeWare® Manual here:

You are currently in the ThemeWare® Knowledge Base. Here you will find an answer to most questions immediately and don't even have to wait for our e-mail.

If you don't find an answer, create a new ticket via our Service Portal. This is the quickest way to get our support.

The ThemeWare® Knowledge Base primarily contains articles on ThemeWare® features. There are of course several overlaps with features of Shopware 6.

If you need more information about the features of Shopware 6, we recommend you take a look at the and the section.

If you have purchased a Shopware extension via the Shopware Store and you have registered your Shopware account in your shop, you can easily install it via the Extension Management.

1. Open the administration of your shop

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

If you have installed an extension, it is basically "ready for use". In order to be able to use the extension, it must be activated.

1. Open the administration of your shop

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

In this article you will learn how to get free access to the popular ThemeWare® Utilities for your ThemeWare® theme.

• Import plugin for a professional Shopping Experience with storytelling elements (Self-hosted)

• Step-by-step instructions for a professional Shopping Experience with storytelling elements (Cloud)

In this article you will learn how to assign ThemeWare®. This means how you make sure that ThemeWare® is represented in your storefront.

First of all, it is important to understand that the basis for delivering a theme is always a Sales Channel. This Sales Channel must be of the type "Storefront" .

If you create a Sales Channel, you can select different types. And "Storefront" would then be the type that is necessary for the theme to be "delivered".

1. Open the administration of your shop

For more information on texts, snippets and translations, see the following tutorial:

Before you start with our tutorials, we recommend you take a look at our and the . There you can learn all the important basics which will help you a lot with the guides.

In addition, we strongly recommend that you take a look at the official Shopware documentation, because many of the things you configure in the guides relate to some of Shopware's core features:

1. Open the administration of your shop

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

3. Switch to the tab "Themes

The ThemeWare® rental version includes a free trial month. Feel free to use this option to test different variants before making your final decision. The rental can be cancelled at any time on a monthly basis or is automatically extended at the prices stated at the time of booking.

Testing ThemeWare®

1. Open the administration of your shop

2. Switch via the main navigation to the "Store" (1) (2) ("Extensions" => "Store")

3. Switch to the tab "Themes" (3)

4. Optional: Enter "ThemeWare" or e.g."Modern" into the search field

5. Now click the ThemeWare® theme you desire in the overview

6. The details page of the ThemeWare® theme will open up now

7. Click the button "Add theme" (4)

8. A pop-up will now open

9. Here you can find all the details about the costs after the trial month (5)

10. Please read and accept the Terms and Conditions (6)

11. Now confirm the booking with "Purchase this extension" (7)

Now you have subscribed to ThemeWare® with a free trial month.

In the next article you will find out how to install ThemeWare®.

If you have further questions or any problems, you can find more information in our detailed tutorial:

The ThemeWare® demo shops present all ThemeWare® themes live and in colour.

Home page

In the upcoming article, you can find more information on how to configure the home page of your theme. In this article, we briefly explain the configuration differences between the Demoshops and the default configuration of ThemeWare®.

Configuration

With ThemeWare® you benefit from extremely regular updates with new features and configurations. To avoid affecting the many ThemeWare® shops of our customers, new features and functions are of course deactivated when they are released. You can therefore decide for yourself whether and if so which new feature you want to use.

However, as we still want to present new features in our Demoshops, the Demoshops will differ slightly from the default configuration of our theme over time. But don't worry, the Demoshops are based entirely on ThemeWare®, you can activate everything we show in the Demoshops yourself with just a few clicks.

You can find all the information about our Demoshops and configuration in the following article. However, we recommend that you complete the introduction first.

With ThemeWare® and ThemeWare® Utilities you get everything you need for your first Shopping Experience:

You will get a free import plugin with which you can import the Shopping Experience of your theme into your shop (self-hosted) with just a few clicks.

As a Shopware Cloud user, you will get a step-by-step guide in PDF format on how to create the Shopping Experience for your theme.

Furthermore, you will get all the required graphic templates in open PSD format.

...

...

First of all, we would like to point out that purchased extensions automatically appear in the Extension Management. A manual upload is therefore not necessary.

The manual upload of extensions is possible in two ways:

• Upload via the Extension Management (recommended)

• Upload via FTP

1. Open the administration of your shop

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

3. Switch to the tab "Themes" (3)

ThemeWare® is now being uploaded.

1. Open the administration of your shop

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

3. Switch to the "Themes" tab (3)

4. Activate ThemeWare® via the switch button (4) on the left of the ThemeWare® logo

5. Clear the entire Shopware cache and reload the administration

ThemeWare® has now been activated.

1. Open the administration of your shop

2. Switch via the main navigation to "Theme Management" (1) (2) ("Content" => "Themes")

   • Note: In the Shopware Cloud, you will find the "Themes" section directly in the main navigation.

3. Now click on your ThemeWare® theme to open the theme configuration

4. In the Tab "General", scroll to the section with the assignment of your theme

5. Click on the Context-Button (3) top right to open a context menu

6. Select the option "Reset to default" (4)

7. A pop-up "Reset theme" appears

8. Reset the theme configuration with the button "Reset to default" (5)

Experienced users can reset the configuration manually via the database. You can find a tutorial on how to do this in the following article:

1. Open the administration of your shop

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

3. Switch to the tab "Themes" (3)

4. Deactivate ThemeWare® via the switch button (4) on the left of the ThemeWare® logo

   • ℹ️ Note: To deactivate a theme, it must no longer be assigned to any Sales Channel!

5. Clear the entire Shopware cache and reload the administration

ThemeWare® has now been deactivated.

One of the biggest advantages of ThemeWare® is its continuous development. You regularly receive new features, sales-promoting features, updates, improvements and, of course, fixes.

There are several ways to find out which changes you can look forward to in which release:

The ThemeWare® Update Newsletter is part of the ThemeWare® Utilities. So you won't miss any more news!

The ThemeWare® theme changelog can be found on the Shopware store page of your theme in the "Changes" tab:

And also in the "Changelogs" section of the ThemeWare® Service Portal:

The ThemeWare® rental version includes a free trial month. The rental can be cancelled at any time on a monthly basis or is automatically extended at the prices stated at the time of booking.

1. Open the administration of your shop

2. Switch via the main navigation to the "Store" (1) (2) ("Extensions" => "Store")

The theme configuration of ThemeWare® can be reached in two ways:

1. Via (recommended)

2. Via the corresponding

In the following we will show you both ways in detail.

1. Open the administration of your shop

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

3. Switch to the tab "Themes" (3)

In dieser Anleitung erfährst du, wie du ein Kategorie-Layout einer Kategorie zuweisen kannst.

1. Wechsel über die Hauptnavigation in die "Kategorie-Verwaltung" (1) (2) deines Shops ("Kataloge" => "Kategorien")

2. Wähle die entsprechende Kategorie aus (3)

You can find out how we created the "Cooking pleasure & Provence" category in our demo shops in the following step-by-step guide:

In this section you will find useful instructions around the topic "Categories"

Before starting to edit your categories or category layouts we recommend you to take a look at our video tutorial. In the video"" we explain important basics which will help you a lot when creating and editing.

In addition, we recommend to have a look at the official Shopware documentation:

You can find out how we created the "Mountain air & Adventure" category in our demo shops in the following step-by-step guide:

How to make product boxes in product listing or sliders more compact is explained in the following article:

In general, when purchasing extensions (apps, plugins or themes) from the Shopware Store, it always makes sense to install them in advance as a "trial version" in the form of a free trial month. This way you can test the extension for 30 days free of charge and make sure that it meets your expectations.

If, despite this, you have accidentally purchased an extension incorrectly, please contact our sales department using the contact form.

Before reporting an issue, you can easily check yourself whether your theme might be responsible for the problem.

Assign the "Shopware default theme" once to your storefront . Does the problem also exists in the default theme, it is 99.9% likely that ThemeWare® is not responsible for the trouble.

You can find out how we created the "Craft & Tradition" category in our demo shops in the following step-by-step guide:

Before reporting an issue, you can easily check whether your individual configuration has an error.

Just use the "Validate" feature in Shopware.

This is useful if you receive an error message such as Invalid configuration – The configuration is faulty. The theme cannot be saved. or the theme could not be saved.

To validate your configuration, open the theme configuration and click on the arrow next to the Save button. There you will find the "Validate" option.

The validation should give you an indication of which value is incorrect.

Learn how to find/fix invalid fields in the following instructions:

Before reporting an issue, you can easily check yourself whether a specific extension (plugin or app) causes the problem.

Deactivate (not uninstall!) all used extension (plugins or apps). If the problem does no more exist after deactivating all extensions, the problem is probably due to an extension.

You can find out how we created the "Mountain air & Adventure" category in our demo shops in the following step-by-step guide:

Before reporting an issue, you can easily check yourself whether a customization, a specific extension (plugin or app) or the theme is responsible for the problem.

To check whether the error or problem is actually caused by the theme, please have a look at the following article:

To check whether the error or problem is caused by a customization, please have a look at the following article:

To check whether the error or problem is caused by a specific extension (plugin or app), please have a look at the following article:

You can find out how we created the "Cooking pleasure & Provence" category in our demo shops in the following step-by-step guide:

In this section you will find many useful instructions around the topic fonts.

Before starting with the font configuration we recommend you to have a look at our video tutorial. In the video "" we explain important basics.

Wie du die Startseite deines Themes erstellen kannst, erfährst du in folgendem Artikel:

In the ThemeWare® plugin configuration (not theme configuration) you have the option to enable the ThemeWare® "Debug mode".

If "Debug mode" is enabled, the "Expert settings", for example, are no longer taken into account.

If you have issues in your shop, activate "Debug mode" once, clear the Shopware cache and your browser cache and then check the Storefront again.

This allows you to check whether there are any problems with your "Expert Settings" with just one click.

Deactivate "Debug mode" when you have finished debugging.

You can find out how we created the "Craft & Tradition" category in our demo shops in the following step-by-step guide:

There are no child themes in Shopware 6 as there were in Shopware 5. Shopware 6 offers you the possibility to create a duplicate of the base theme. With this duplicate you can create a separate configuration, for example for an additional Sales Channel.

For more information on theme duplicates, click here:

Template customizations are not possible with theme duplicates, because duplicates do not have their own file level. Template files must therefore be implemented in their own themes or with extensions.

For more information, click here:

1. Open the administration of your shop

2. Change via the main navigation to the "Theme Management" ("Content" => "Themes")

   • Note: In the Shopware Cloud, please find the section "Themes" directly in the main navigation.

3. Now click onto the Context button in the upper right of the preview image of your ThemeWare® base theme in order to open the Context Menu.

4. Click "Create duplicate"

5. A pop-up will appear again allowing you to enter the name for the duplicate

6. Confirm the creation with "Create duplicate".

Now you have created a ThemeWare® theme duplicate and you are free to configure it independently from the Parent Theme.

1. Open the administration of your shop

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

3. Switch to the tab "Themes" (3)

4. ThemeWare® is now being displayed in the overview

5. Now install the extension via the option "Install". (5)

ThemeWare® has now been installed.

With ThemeWare® you show a second product image in the product listing as soon as your customers move the mouse over a product tile. This lets you reveal the back, a detail or the product in use – without opening the product page.

Requirements

• a product you want to assign a second image to

• a suitable image for the hover effect in the Shopware media manager

Step 1: Enable the hover effect in the theme

"Theme Manager" => your ThemeWare® theme => "Listing pages" tab => "Product box" block => "Product image" section

Set the "Hover effect" configuration to "crossfade images (Custom field)" and save your changes.

"Catalogues" => "Products" => select product => "Specifications" tab => "Custom fields" section => your theme's custom field set

In the "Hover image" custom field, select the desired image from the media manager and save the product.

When your customers hover over a product tile in the listing, the cover image gently crossfades into the hover image. If nothing shows up, clear the Shopware cache once.

You can find all details about the custom field in the ThemeWare® manual:

1. Open the administration of your shop

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

3. Switch to the tab "Themes" (3)

4. Click the Context-Button (4) next to the theme in order to open the context menu and click "Remove" (5)

5. Log in to the Shopware Account within the tab "Shopware Account" with your account update your data so that the deletion of the extension is updated in the entire system.

Extensions with valid licenses will be displayed in the Extension Management even after "removing" them, because the corresponding account still owns this license. You can remove/archiv the license itself in your Shopware Account:

• Go to your Shopware Account at and cancel the rental there. Without this cancellation, the rental contract will continue to be charged.

With ThemeWare® you benefit from continuous development. From time to time, therefore, we may remove or replace configuration fields.

If "orphaned configuration fields" remain in the configuration, you can remove them as follows:

1. Open the administration of your shop

2. Switch via the main navigation to "Theme Management" (1) (2) ("Content" => "Themes")

   • Note: In the Shopware Cloud, you will find the "Themes" section directly in the main navigation.

3. Now click on your ThemeWare® theme to start editing

4. Click on the dropdown icon at the "Save"-Button

5. Save your configuration with the option "Clean Save" (4)

ThemeWare® has now been cleaned up.

With ThemeWare® you benefit from continuous further development. Therefore, from time to time we might remove or replace configuration fields.

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

On our hint (NEXT-14571) Shopware has extended the "Save" button in the theme configuration in Shopware 6.4.8.0 and added a "Clean" function. With this you are able to delete "Orphaned configuration fields".

"The current values are completely re-saved. To be used when fields have been deleted or have changed their type."

"Orphaned configuration fields" occur when a configuration field has been edited and this configuration field is deleted with a theme update.

In this case, your configuration will remain in the database and this configuration will end up as a configuration field in the tab "General".

Typically, this field then has the technical name and not the original label as its name.

When Shopware is running in production mode, usually only general messages like "Theme could not be assigned to sales channel." are being displayed. Based on these general messages, it unfortunately is not possible to identify the cause of the error more precisely.

The first step in case of error messages in the administration is to receive a more detailed error message.

Receiving more detailed error message

To receive a more detailed error message use one or both of the following options:

• Check your PHP error log for further information.

  • In case you don't know how to change the value, your hoster will certainly be happy to help you.

• Put Shopware (temporarily) into the debug mode.

  • Please find a guidance in the .

1. Open the administration of your shop

2. Switch via the main navigation to the "Theme Management" ("Content" => "Themes")

   • Note: In the Shopware Cloud, you will find the section "Themes" directly in the main navigation.

3. In order to open the context menu, click onto the Context button in the top right-hand corner of the ThemeWare® duplicate preview image.

4. Click "Rename"

5. A pop-up will appear again in which you can change the name of the duplicate

6. Confirm the change with "Save".

If you have any questions or problems, our popular ThemeWare® Service Portal is available around the clock. There you will find all the links to ThemeWare®, useful tools, answers to the most frequently asked questions, solutions to every known problem and news about ThemeWare® and Shopware 6.

The Service Portal is therefore always the first point of contact for all matters relating to ThemeWare®:

Thanks to thousands of tickets, we have already answered most of the questions and most of the bugs have long been known and solved. So that all customers can benefit from this knowledge, we have documented our knowledge in the ThemeWare® Knowledge Base, the ThemeWare® Manual and the ThemeWare® Video Tutorial.

In addition, you can find almost all information about Shopware 6 in the Shopware Documentation.

This allows you to solve almost all questions and problems yourself without having to wait for our answer.

The ThemeWare® rental version includes a free trial month. The rental can be cancelled at any time on a monthly basis or is automatically extended at the prices stated at the time of booking.

1. Open the administration of your shop

2. Switch via the main navigation to the "Store" (1) (2) ("Extensions" => "Store")

We are always happy to receive an honest rating. The rating does not have to be long, 1-2 sentences are sufficient.

There are two methods of rating ThemeWare®:

1. Using your (recommended)

2. Using your

1. Open the administration of your shop

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

3. Switch to the tab "Themes

In dieser Anleitung erfährst du, wie du eine Kategorie-Seite anlegen kannst.

1. Wechsel über die Hauptnavigation in die "Kategorie-Verwaltung" (1) (2) deines Shops ("Kataloge" => "Kategorien")

2. Wähle die gewünschte Kategorie aus in welcher die neue Kategorie erscheinen soll

With ThemeWare® you give your category pages a large "Hero section" – an inviting header area with the category name, a background image and an optional breadcrumb. Give your categories a premium look, strengthen your brand and guide customers straight into your assortment.

• a category you want to add a "Hero section" to

• optionally a background image (recommended image size: 1920 x 1080 pixels)

With ThemeWare® you show a category's subcategories as tiles or links above the product listing. This guides your customers to the right range faster, improves internal linking and makes your category menu visible right on the page.

• a category that has visible subcategories

• optionally a display image per subcategory

In the theme configuration you will occasionally find variables in color fields. This unifies the color image of your Storefront and makes it easier to customize the color image to your preferences.

There are two relevant notations for variables:

1. Shopware variables:

In the theme configuration you may also use simple SCSS functions in color fields in addition to theme variables. With such functions you can darken or lighten colors, for instance.

A error-free syntax is important to avoid errors in the storefront, therefore these functions are recommended for experienced users.

In the following we will introduce a few useful SCSS functions. Please find more information in the official .

To darken colors you may use the "darken" function:

To lighten colors, use the "lighten" function:

In dieser Anleitung erfährst du, wie du ein Kategorie-Layout erstellen kannst.

1. Wechsel über die Hauptnavigation in die "Erlebniswelt-Verwaltung" (1) (2) deines Shops ("Inhalte" => "Erlebniswelten")

2. Optional: Du kannst die Layouts über den Reiter "Kategorieseiten" auf diesen Seitentyp eingrenzen (3)

In dieser Anleitung erfährst du, wie du ein Kategorie-Layout mit Sidebar erstellen kannst.

1. Wechsel über die Hauptnavigation in die "Erlebniswelt-Verwaltung" (1) (2) deines Shops ("Inhalte" => "Erlebniswelten")

2. Optional: Du kannst die Layouts über den Reiter "Kategorieseiten" auf diesen Seitentyp eingrenzen (3)

ThemeWare® provides you with the option of importing Google Fonts automatically.

1. Choose a of your preference

2. Click the "+ Select this style" button next to a style of the font. (1)

With ThemeWare® you highlight a single category in the top navigation with colour – for example your sale, new arrivals or promotion category. This way you deliberately draw your customers' attention to the menu item that matters most to you.

• a category you want to highlight in the top navigation

• the "Top navigation" layout type in the header (the highlighting does not apply to the "Entry point main navigation")

The theme configuration of ThemeWare® can be achieved in two possible ways:

1. Via the corresponding Sales channel (recommended)

2. Via the Theme configuration

In the following we show you both ways in detail.

1. Open the administration of your shop

2. Switch via the main navigation to the sales channel of your storefront in the section "Sales Channels" (1)

3. Switch to tab "Theme" (2)

ThemeWare® has now been assigned to your storefront.

1. Open the administration of your shop

2. Switch via the main navigation to the "**Theme Management **" (1) (2) ("Content" => "Themes")

   • Note: In the Shopware Cloud, you will find the section "Themes" right in the main navigation.

ThemeWare® has now been assigned to your storefront.

Custom fields are a core feature of Shopware 6 and let you extend products, categories or manufacturers individually. With custom fields you flexibly store additional information and output it in the storefront when needed.

The following step-by-step guide shows how to create a custom field, using a GPSR "safety notice" as an example.

Creating a custom field set

1) Create a new custom field set

Go to the custom field management:

"Settings" => "System" => "Custom fields" => "Create set"

Click "Create set" and create a new custom field set.

• Technical name: e.g. custom_gpsr

• Label: e.g. GPSR (products)

• Use for: Products

Click "New custom field" and create a new custom field.

• Type: e.g. Text editor

• Technical name: e.g. custom_gpsr_safety_notice

• Label: e.g. Safety notice

Go to the product management and edit the desired product. Fill in the new custom field (e.g. "Safety notice"):

"Catalogues" => "Products" => "Specifications" tab => "Custom fields" section => "GPSR (products)" tab => "Safety notice" field

Since neither Shopware nor ThemeWare® can know where your individual custom field should appear, you embed it manually – either via a CMS element in a Shopping Experiences layout (simple, from Shopware 6.6.9) or via an individual template customization (more flexible, incl. empty check):

Many ThemeWare® features already use prepared custom fields – so you don't create anything yourself, you just fill in the fields and enable the feature in the theme configuration. The matching step-by-step guides:

Product pages

Categories & navigation

You can find more information about ThemeWare® custom fields in the ThemeWare® manual:

With ThemeWare® you extend the flyout of your top navigation with up to three teasers featuring an image, text and link. Highlight promotions, topic worlds or top products right in the mega menu and guide your customers straight from the navigation to the matching destination.

Requirements

• a category in the top navigation whose flyout you want to extend with teasers

• one to three images for the teasers in the Shopware media manager

• optionally the target URLs (links) for the teasers

"Theme Manager" => your ThemeWare® theme => "Header" tab => "Top navigation flyout" block

The "Top navigation flyout" field offers several ways to display the submenus (see the "More flyout modes" section below). For the teasers, choose "ThemeWare® Flyout with teasers" and save your changes.

"Catalogues" => "Categories" => select category => "General" tab => "Custom fields" block => "Flyout (... Pro)" custom field set

Fill in the following custom fields per teaser (up to 3 teasers are available):

• Flyout teaser 1–3 – Image – the teaser image from the media manager

• Flyout teaser 1–3 – Text – the text below the image

• Flyout teaser 1–3 – Link – the target URL; the whole teaser is clickable

Save the category.

When you open the category's flyout in the top navigation, the teasers now appear next to the subcategories. If nothing shows up, clear the Shopware cache once.

The "Top navigation flyout" field generally controls how the submenus of your top navigation are displayed – the teasers are just one of several modes:

• Shopware default – the native Shopware navigation (without the ThemeWare® flyout)

• ThemeWare® Flyout – the standard flyout with the subcategories

• ThemeWare® Dropdown – the submenus as a compact dropdown

You can find all flyout modes with example images in the ThemeWare® manual:

The teaser custom fields in detail:

In the so-called ThemeWare® Shopping Experiences Header, the header overlays the Shopping Experience on the main page or on selected category pages. This is a configurable effect to enable a particular look in ThemeWare®.

In themes like ThemeWare® Exquisite, ThemeWare® Lights or ThemeWare® Outdoor the "Shopping Experiences Header" is already configured. The corresponding look you may have a look at in the corresponding demo shops:

• ThemeWare® Exquisite

You are able to de-/activate the "Shopping Experiences Header" via the ThemeWare® configuration.

The corresponding configuration is available in the Tab "Header" => Block "Shopping Experiences Header" => Field "Shopping Experiences Header".

1. Option "don't apply (default)":

   • This option virtually is the default header representation.

   • The Shopping Experience is placed after the header. The header does not overlay the Shopping Experience.

In order that the "ThemeWare® Shopping Experiences Header" can develop its full effect, the Shopping Experience on your main page needs a suitable Shopping Experience element in the first place. Especially suitable are blocks like "Image, full-sized" or "Image slider" out of the block category "Image".

The images used should be sufficiently large (e.g. 1920x1024px) and thus compressed as well as possible. In addition, you should choose or create motifs in which as little as possible "happens" in the upper area of the image, in order that the logo, buttons and navigation are still easily recognizable.

Screenshots

In the configuration of the theme in the Theme Management you have different types of fields available. In the following we will provide you with an overview and explain the use of each field type and the values it can contain.

The number field can only contain numbers. The possible numbers may be limited by the field.

Example values: 10, 0, -10, etc.

You can easily select a colour using the colour picker. Alternatively, you can also enter a

The "spacing" or "gaps" in product boxes – for example in product listings or product sliders – are intended by Shopware and already exist in the standard theme.

Technically, these are placeholders for information that are available depending on the product configuration and then should be displayed.

In order to avoid that each product box has a different height due to the lack of information in some products, these "placeholders" exist.

Information in these "placeholders" are for example the rating stars or the variant characteristics:

In this article you will learn everything about ThemeWare® theme duplicates in Shopware 6.

What is a ThemeWare® duplicate?

Basically, a theme duplicate is nothing more than another entry in the Shopware 6 Database. This allows you to save an alternative or separate theme configuration (e.g. for additional sales channels).

The theme duplicate inherits when created the current configuration of the base theme or parent theme (often as well called "mother theme"). This is similar to the handling of Variant Articles. More about the configuration you will learn below in this article.

Parent theme vs base theme

In principle, parent theme and base theme mean the same Theme. base theme virtually means the "original" theme you have purchased or rented. In the following, we use the term parent theme to make clear that there is also a theme duplicate of the base theme.

base theme or parent theme + theme duplicate

Difference to the Shopware 5 theme derivation

Theme derivations in Shopware 5 have, in addition to the entry in the Database for the configuration, also created folders and files on the server, through which then individual customizations could be realized or additional files (e.g. fonts) could be included.

A theme duplicate in Shopware 6 does not (currently) provide you with a folder and files for customization.

As explained above, individual customizations (e.g. via templates) cannot be realized with duplicates.

Sorting configuration fields

Another limitation is a Shopware bug that affects the sorting of configuration fields in theme duplicates:

Caused by this bug, theme duplicates ignore the vendor-defined order for configuration fields and unfortunately represent them in a "random" order.

Unfortunately, this affects all themes.

Note: In Shopware 6.4.8.0 this bug was fixed by Shopware.

New configuration fields of the base theme are missing in the duplicate.

In addition, there is another Shopware bug in Shopware 6 that causes new configuration fields to not be automatically transferred to duplicates when updating from the Parent Theme.

Unfortunately, this affects all themes.

Tip: How to transfer missing configuration fields to your duplicate, you can read in our article. .

Note: In Shopware 6.4.8.0 this bug was fixed by Shopware.

Since Shopware 6.4.8.0 the theme duplicates work much better than before. The issues we reported to Shopware have finally been fixed by Shopware and therefore, there are currently no further restrictions when using theme duplicates.

• New configuration fields are now included in theme duplicates when updating the Parent Theme.

• The sorting of the configuration fields now corresponds with the sorting of the Parent Theme.

Of course you may just go ahead and configure the base theme. At any time you are able to create a duplicate and reset the configuration from the base theme when necessary.

In case you need a separate configuration (e.g. for another sales channel), you should solve this via a theme duplicate. There is no need to purchase/rent another theme for it.

Parent Themes cannot be deleted via the Theme Management and therefore have a small lock icon next to their name.

theme duplicates, on the other hand, can be deleted via the Theme Management and therefore do not have this icon:

This is as well visible in the context menu via the Context Button of each Theme. Moreover, from duplicates, you cannot create more duplicates and delete base themes from Theme Management:

In addition, there is a note in the theme configuration that this theme is a duplicate of theme XY:

How to create a ThemeWare® theme duplicate, you will find in the article:

How to rename a ThemeWare® theme duplicate, please read in the article:

Configuration fields in a theme duplicate are grayed out. This means that this configuration field is derived from the base theme and therefore equals the configuration field from it.

You probably know the handling of inherited configuration fields from variant articles.

In case you wish to configure a configuration field differently, just click onto the "Anchor" Icon "Remove inheritance".

In case you wish to restore the value of a configuration field from the base theme, click onto the "Anchor" icon. "Restore inheritance".

Up to Shopware 6.4.8.0 there are a few restrictions in theme duplicates due to Shopware Bugs. These have at last been fixed with Shopware 6.4.8.0.

Please find out more in the section [#restrictions-on-theme-duplicates].(themeware-duplikate.md#einschraenkungen-bei-theme-duplikaten "mention").

In this article you will learn how to self-host your own fonts or Google Fonts respectively how to store them locally on your webserver and how to embed them in your Shopware 6 shop (self-hosted).

Preface

In order to easily deposit the font files and the corresponding CSS customizations you should use a separate extension (plugin or app) for individual customizations.

• Please check if there already exists a suitable extension in the Shopware Community Store.

• Alternatively, you may use the following manual method.

The easiest way is to provide the files in the folder "public" of your Shopware installation.

In our example we wish to use the Google font "Titillium Web" for text and headlines in a font weight of "400" and "600". In order to download the fonts, we recommend the free service .

1. Look for the desired font in the upper left and select it (e.g. "Titillium Web").

2. Specify the required font weights under "2. Select styles". (e.g. regular/400 and bold/600)

3. As folder prefix under "3. Copy CSS" you can leave it at "../fonts/".

1. Unzip the ZIP archive and upload the fonts via FTP to the folder "Fonts". Folder path: public/fonts/

2. Switch to the folder "css" and create the file "fonts.css" Folder path: public/css/

1. Open ThemeWare® in the Theme Management and switch to the Tab "Layout" => Block "Typography":

   1. Enter your font in the Section "Text" and/or "Headlines". (e.g. "'Titillium Web', sans-serif")

   2. Enter your font weights in the Section "Font weight" (light, normal, bold). (e.g. 400, 400, 600)

• Check whether fonts are no longer loaded via the Google Fonts API.

This article explains how you can self-host your own fonts or Google Fonts respectively how to store them locally on your webserver and how to integrate them into your Shopware 6 shop (self-hosted) using our free "ThemeWare® Customizing Plugin".

In order to easily deposit the font files and the corresponding CSS customizations you should use a separate extension for individual customizations.

• Please check whether there already is a suitable extension in the .

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.

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

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.

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.

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.

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

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

2. 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 ().

3. If the current version of ThemeWare® is not compatible

These three cases are considered in the following instructions:

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

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.

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

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.

There are three options for Shopware updates:

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

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

2. Then deactivate your ThemeWare® theme

   • Tip: Clear the entire Shopware cache once

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

2. Then deactivate your ThemeWare® theme

3. Clear the entire Shopware cache once

• 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.

This message is largely self-explanatory. The extension in question is not available in the Shopware Store and therefore cannot be updated automatically. In this case, please update it manually or deactivate it before updating Shopware until compatibility has been checked and confirmed.

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 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 ).

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

Always refer to our update guide when updating ThemeWare®:

• FAQ:

• FAQ:

• FAQ:

• FAQ: