Extensions

The extensions allow you to extend the functional range of your shop.

Store

In the submenu Store, you have the possibility to purchase extensions. There are both free and paid extensions available.

Using the selection menus and filters above the list, you have the possibility to limit the displayed extensions.

To do this, you can change the Sort (1) and select Category (2) and Rating (3). You can also select the app's payment (4) and filter for options such as support or a trial version under Other (5). To get more information about an extension or to purchase it, just click on the corresponding extension (6).
Then the detail page of the extension will open.

Add an extension

To use an extension, it is first necessary to add it to the shop.
To do this, click on the button Add extension (1) on the details page.

A modal will then open and guide you through the rest of the process.

First of all, it is necessary to agree to the terms and conditions (1). Depending on the function of the extension, it may be necessary to confirm that the extension requires authorisation to access individual shop functions (2). You can view the exact information by clicking on the link Show authorisations.
When you have confirmed all necessary checkboxes, you can add the extension to your shop.

As soon as the process is completed, this is confirmed with a success message.
The extension will then be listed in the My extensions section.

My extensions

In the area My extensions you get an overview of all purchased apps and have the possibility to (de)install them.

Apps

Overview of apps (1): Here you can see an overview of all apps and the most important information about each app.
Hide inactive extensions (2): Use this button to hide all apps that are currently not activated in order to obtain a better overview of the active apps.
Sorting (3): Here you can specify the criterion according to which the overview should be sorted.
Active button (4): With this button you can activate or deactivate installed apps. In contrast to uninstalling, deactivating has the advantage that settings you have made in the app are not lost.
Context menu (5): Here you can call up the context menu for the respective apps. Different functions are then available in the menu, depending on the status of the app.
Permissions: Displays to which components the extension has access. Furthermore you can see which permissions (view, edit, create, delete) the extension has.
Update: Here you can update the extension by uploading a different version as a zip file.
Uninstall. Uninstalls the app
Upload extension (6): Here you can manually add an extension to the shop.

If you upload extensions from a MacOS system, be aware that MacOs creates a subfolder in the zip file when compressing it, and then you can't upload the extension. You can easily remove this subfolder with the following console command.
zip -d data.zip "__MACOSX/*"
zip -d data.zip "*/.DS_Store"

Apps purchased from the Store should always be installed via the Admin Store and not by uploading a file.

Themes

Overview of themes (1): Here you can see an overview of all themes and the most important information about each theme.
Hide inactive extensions (2): Use this button to hide all themes that are currently not activated in order to obtain a better overview of the active themes.
Sorting (3): Here you can specify the criterion according to which the overview should be sorted.
Active button (4): With this button you can activate or deactivate installed themes. In contrast to uninstalling, deactivating has the advantage that settings you have made in the theme are not lost. Themes that are active here are not automatically assigned to a sales channel. The assignment only takes place in the sales channel.
Context menu (5): Here you can call up the context menu for the respective apps. Different functions are then available:
Open extension: Forwards you directly to the Themes area and opens the theme settings.
Data privacy & safety: Takes you to an external page for the theme manufacturer's privacy policy.
Privacy policy extensions: Indicates whether personal data is processed by the manufacturer. Optionally, the manufacturer provides information about the privacy policy.
Permissions: Displays to which components the extension has access. Furthermore you can see which permissions (view, edit, create, delete) the extension has.
Update: Here you can update the extension by uploading a different version as a zip file.
Uninstall. Uninstalls the app
Upload extension (6): Here you can manually add an extension to the shop.

Install extension

To install an existing extension, click on the Install App button in the My extensions section.

If the extension provides its own configuration menu, you can access it by clicking on Open app.

Cancel and remove extension

If you no longer wish to use a rental extension that is subject to a charge and wish to terminate the rental, the complete removal is necessary. Simply deactivating or uninstalling the extension is not sufficient.
Please note, however, that in this case the settings of the extensions will also be removed.
To cancel and remove the extension, click on the "..." button and in the menu that opens click on cancel and remove.

Afterwards a window will open in which you can confirm this once again.

SaaS updates and extensions

Your SaaS environment is updated from time to time. To ensure that your shop is not affected by incompatible apps, we point this out at an early stage under Extensions > My Extensions.

Incompatible apps

Incompatible apps are displayed in the list in your admin under Extensions > My Extensions.

The apps marked as incompatible have the following meanings:

The app is not (yet) marked as compatible with the upcoming major version of Shopware by the app’s manufacturer.
The manufacturer still has time until the release to update their app to be compatible with the next Shopware version.
If the app is not updated by the manufacturer and thus incompatible at the time of the release, the app will be automatically disabled.

Necessary data for adding extensions

In order to obtain an extension, it is necessary to maintain some data in the shop beforehand.
If you are not able to add an extension, you will receive a corresponding message with information about which data is not (completely) available.

Payment method for billing

The payment method for the settlement is needed to pay any rent for the extensions.
Please note that these data must be filled in in advance even in the case of free extensions.
You can maintain this data under Settings > Account > Billing > Payment method.