> For the complete documentation index, see [llms.txt](https://knowledge.themeware.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.themeware.design/more-knowledge/themeware-tools/themeware-customizing-plugin.md).

# 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](https://store.shopware.com/en/extensions/?p=1\&o=12\&n=21\&c=2069\&shopwareVersion=6) or our free "ThemeWare® Customizing Plugin" (an extension based on the plug-in system of Shopware 6).

{% hint style="info" %}
**Note**: Please use the "[ThemeWare® Customizing App](/more-knowledge/themeware-tools/themeware-customizing-app.md)" in the Shopware 6 Cloud.
{% endhint %}

***

## Download

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

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

{% hint style="warning" %}
**Important**: Please note that we offer the "ThemeWare® Customizing Plugin" free of charge and **cannot provide support** for the plugin or individual customizations.
{% endhint %}

***

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

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

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

<figure><img src="/files/DpXzZgzbYzeohvfmtPpF" alt=""><figcaption><p>ThemeWare® Customizing Plugin</p></figcaption></figure>

### Activate/deactivate example implementations

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

***

## Structure and function

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

***

## Update

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:

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

{% hint style="warning" %}
**Important**: Please note that we offer the "ThemeWare® Customizing Plugin" free of charge and **cannot provide support** for the plugin or individual customizations.
{% endhint %}

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

### Manual update

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.

{% hint style="info" %}
**Note**: You can find the latest version in the [ThemeWare® Utilities](https://service.themeware.design/en/themeware-utilities).
{% endhint %}

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

### Shopware 6.7

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

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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.6.*"
},

"require": {
<strong> "shopware/core": "6.7.*"
</strong>},
</code></pre>

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:

{% code title="base.html.twig" %}

```twig
{% block base_header %}

>>
{% block base_body_inner %}
```

{% endcode %}

{% hint style="info" %}
**Note**: Please note that your individual customizations may also need to be made compatible.
{% endhint %}

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

{% embed url="<https://service.themeware.design/en/news/20250519-shopware-6.7-what-you-need-to-know>" %}

### Shopware 6.6

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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.5.*"
},

"require": {
<strong> "shopware/core": "6.6.*"
</strong>},
</code></pre>

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

{% hint style="info" %}
**Note**: Please note that your individual customizations may also need to be made compatible.
{% endhint %}

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

{% embed url="<https://service.themeware.design/en/news/20240308-shopware-6.6>" %}

### Shopware 6.5

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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.4.*"
},

"require": {
<strong> "shopware/core": "6.5.*"
</strong>},
</code></pre>

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:

{% embed url="<https://www.shopware.com/en/news/shopware-6-5/>" %}
Shopware 6.5 – all about the brand new major release
{% endembed %}

### Shopware 6.4

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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.3.*"
},

"require": {
<strong> "shopware/core": "6.4.*"
</strong>},
</code></pre>

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:

<pre class="language-twig"><code class="lang-twig">shopware.theme["..."] => theme_config('..')

>>
<strong>shopware.config.core... => config('core...')
</strong></code></pre>

> State: Shopware 6.7.0