# ThemeWare® Shopping Experiences 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.

{% hint style="info" %}
**Note**: For Shopware 6 Cloud users, we recommend the step-by-step instructions in PDF format from our [ThemeWare® Utilities](https://service.themeware.design/en/themeware-utilities).
{% endhint %}

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**:

{% embed url="<https://service.themeware.design/en/themeware-utilities>" %}
ThemeWare® Utilities
{% endembed %}

> *Last updated: May 2026* (v2.0.1)

{% hint style="warning" %}
**Important**: Please note that we offer the "ThemeWare® Shopping Experience Import" plugin free of charge and **do not provide support** for the plugin.
{% endhint %}

***

## Installation

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

{% hint style="warning" %}
**Important:** Please note that the data is imported when the plugin is activated and may overwrite existing data (previous imports).
{% endhint %}

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

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

<figure><img src="/files/b5NFelAjZjAwXqPX3gqH" alt=""><figcaption><p>Extension management</p></figcaption></figure>

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

{% content-ref url="/pages/6SwdQhKwnpUoxFAhMTbE" %}
[Install extensions manually](/knowledge-base/shopware/configuration/extensions/installing-extensions-manually.md)
{% endcontent-ref %}

> **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.
>
> <img src="/files/PiyGIkfLN2HfYonSTxEi" alt="" data-size="original">
>
> Please create the appropriate folder so that the installation works:
>
> [Create default folder for media](/knowledge-base/basic-knowledge/images/create-default-folder-for-media.md)

{% hint style="info" %}
**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.
{% endhint %}

***

## Editing the Shopping Experience

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

<figure><img src="/files/x6QPsaueksBwepEXx8N4" alt=""><figcaption><p>Shopping Experience management</p></figcaption></figure>

### Important: Duplicate the Shopping Experience template

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.

***

## Images & Products

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

{% hint style="info" %}
**Tip**: You also get PSD templates of the preview images with ThemeWare® Utilities Mail.
{% endhint %}

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.

***

## Activating, deactivating and uninstalling

### Activating

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

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.

### Uninstalling

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
* The media folder `ThemeWare® <Theme name>` is kept as long as it still contains images

**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
* The media folder `ThemeWare® <Theme name>` is removed if empty

***

## Update

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.


---

# Agent Instructions: 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:

```
GET https://knowledge.themeware.design/more-knowledge/themeware-tools/themeware-shopping-experiences-import-plugin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
