> For the complete documentation index, see [llms.txt](https://docs.themeware.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.themeware.design/additional-features/hub/variants.md).
# Variants
The variants tab shows all 15 ThemeWare® variants. Creating a variant produces a new theme duplicate in the look of the selected variant. Your existing theme of course stays untouched.
{% hint style="info" %}
**Which function do you need?**
**Create variant** — create a fresh variant, quick and clean, **without** your existing customizations.
**Take over configuration** — create a variant and **bring along** your customizations (logos, colours, texts) from an existing theme.
{% endhint %}
***
## Filters & tags
In the Variants tab in the Hub, you can filter the overview by:
* **Top sellers** — the five best-selling variants
* **Popular** — popular variants across all styles
* **Light** — designs with a light, friendly look
* **Dark** — designs with a darker feel
* **Boxed** — designs with a boxed layout
* **Included** — the five variants already bundled
* **Add-on** — the ten variants you can unlock
***
## Create variant
1. *Optional*: pick a filter (e.g. Top sellers, Light, Dark, Boxed) to narrow the list.
2. Click the desired variant card. The "Create variant as duplicate" modal opens.
3. Review the selection (source and target).
4. Click "Create variant".
The new duplicate then appears in your Theme-Manager.
{% hint style="warning" %}
**Sales channel assignment**\
The newly created duplicate is not yet assigned to a sales channel. Open the Theme-Manager and assign the theme to your desired sales channel for it to go live in the storefront.
{% endhint %}
{% hint style="info" %}
**Logos**\
Logos are inherited from your current variant's plugin theme — your own uploaded logos are included. You can swap them in the Theme-Manager after creating.
{% endhint %}
{% hint style="info" %}
**Background images**\
These variants ship with factory background images: **Bath, Bike, Bio, Electric, Exquisite, Fit, Global, Kids, Living, Outdoor, Plants, Strong**.
**When switching to a variant without a background** (e.g. Bike → Modern), the old background image of the source variant initially stays visible — this is a [known Shopware limitation](https://github.com/shopware/shopware/issues/10702) that we cannot resolve automatically right now.
You have two easy ways to remove the background image in the new theme:
1. **Hide it** (recommended): In the Theme-Manager you'll find a show/hide option next to each background image. Set it to "do not show" — the image disappears immediately without you having to remove the media.
2. **Upload your own**: Simply set a different image in the Theme-Manager — this overrides the inherited factory background.
{% endhint %}
***
## Take over configuration (Migration)
Take over the look and customizations from another installed ThemeWare® variant (Pro or Cloud) into your current theme. Useful for example when moving from the Cloud app to the Pro variant, or when you want to continue with a different variant as your base.
{% hint style="info" %}
**Note**: The flyout cards are still in development. We welcome your constructive [feedback](https://service.themeware.design/en/feature-request).
{% endhint %}
**Prerequisite:** at least one second ThemeWare® variant (Pro or Cloud) is installed in the shop. Otherwise a notice is shown instead of the selection field.
**Step by step:**
1. In the "Take over configuration" section, pick the source from the dropdown. Available are all other ThemeWare® variants (Pro/Cloud) plus their duplicates.
2. The target is automatically your current theme (shown read-only next to the source).
3. Click "Take over configuration".
A new duplicate is created under your current theme as parent. The look and customizations of the source (logo, colors, typography, etc.) are preserved.
{% hint style="warning" %}
**Sales channel assignment**\
The newly created duplicate is not yet assigned to a sales channel. Open the Theme-Manager and assign the theme to your desired sales channel for it to go live in the storefront.
{% endhint %}
{% hint style="info" %}
**Cloud app as source**\
ThemeWare® Cloud editions (apps) can also serve as a source. Handy when moving from Cloud to Pro: take over the cloud configuration once, then uninstall the cloud app.
{% endhint %}
{% hint style="info" %}
**Source = duplicate**\
If you select a duplicate as the source, customizations from the underlying plugin or app theme are transferred as well.
{% endhint %}
{% hint style="success" %}
**Uninstall the source**\
After a successful take-over the source plugin or app is no longer needed for the new theme — you can safely uninstall it.
{% endhint %}
***
## Premium variants (Add-on)
For details on the available add-on variants, tags and prices, see the Add-ons overview.
{% content-ref url="/pages/aFKwAqgQNr67IaKWh50D" %}
[Design variants](/additional-features/add-ons/design-variants.md)
{% endcontent-ref %}
***
## Use cases
Typical scenarios for both functions:
### Create variant
* **Try out a variant** — You want to see how another variant (e.g. Plants) would look with your setup, without altering your existing theme.
* **Different looks per sales channel** — You run multiple sales channels and want to assign each one a different variant.
* **Fresh start** — You want to start over with the factory defaults of a variant, without your previous customizations.
### Take over configuration
* **Switch between two Pro plugins** — You have e.g. ThemeWare® Plants and Modern installed in parallel and want to continue your Plants configuration under Modern.
* **Switch from Cloud (app) to Pro (plugin)** — You have the cloud app installed, buy the Pro plugin in addition, and want to take over your cloud configuration. The cloud app can then be uninstalled.
* **Variant no longer offered in the store** — Your previous variant is no longer available for purchase. You switch to an active variant and bring your setup along.
* **Continue with a custom duplicate as base** — You have a polished custom duplicate under one variant and want to continue its look under a different variant.
{% hint style="info" %}
**Want to write into an existing theme instead of creating a new one?**\
The [Backup tab](/additional-features/hub/backup.md) is for that: export the configuration from the source, import it into the target theme. It also provides a safety net with mandatory backup before overwriting.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.themeware.design/additional-features/hub/variants.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.