Skip to content
Guide /

Installation

SSD plugins install like any standard Shopware 6 extension — from the Shopware Store, via Composer, or by uploading a zip. This page covers the requirements and all three install paths, plus activation.

Requirements

  • A supported Shopware 6 store, with admin access to manage extensions.
  • Composer 2, if you install from the command line.

The exact Shopware and PHP versions differ from plugin to plugin — each plugin declares its own on its Shopware Store listing and in its composer.json (the shopware/core constraint). Always check the requirements of the specific plugin and version you're installing.

Check compatibility first

Confirm the plugin version supports your exact Shopware version before installing on production — there is no single Shopware or PHP version that applies to every SSD plugin.

  1. In the Shopware admin, go to Extensions → Store.
  2. Search for the plugin (e.g. SSD Reward Engine) and click Add to account.
  3. Open Extensions → My extensions, find the plugin, and click Install.
  4. Toggle the plugin active.

Store installs handle updates and licensing automatically through your Shopware account.

Option B — Composer (Shopware Store registry)

Store extensions are not installed from a public vendor/package name — they come from Shopware's own Composer registry. You authorize your project once, then require the extension by its Store package name (the technical name, in lowercase).

1. Authorize the Shopware Composer registry (once per project). In account.shopware.com, open the extension and click Install via Composer to generate a token, then run from your project root:

bash
composer config repositories.shopware-packages '{"type":"composer","url":"https://packages.shopware.com"}'
composer config bearer.packages.shopware.com <your-token>

This writes an auth.json in your project root — add it to .gitignore.

2. Require the extension by its Store package name — the plugin's technical name in lowercase, prefixed with store.shopware.com/:

bash
composer require store.shopware.com/<plugin-store-name>
# e.g. the Reward Engine:
composer require store.shopware.com/ssdrewardengine

3. Install and activate using the plugin's technical name (PascalCase):

bash
bin/console plugin:refresh
bin/console plugin:install --activate <PluginName>
bin/console cache:clear
# e.g. --activate SsdRewardEngine

Two names, one plugin

The Store package name (e.g. store.shopware.com/ssdrewardengine) is always lowercase and is what Composer downloads. The technical name (e.g. SsdRewardEngine, PascalCase) is what the bin/console plugin:* commands use. Both are listed on each plugin's own documentation and Store listing.

Option C — Zip upload

  1. Go to Extensions → My extensions → Upload extension.
  2. Select the plugin .zip file.
  3. Click Install, then toggle it active.

After installing

  • Clear the cache if you installed via the CLI: bin/console cache:clear.
  • Run database migrations — these run automatically on install/activate; if you deploy with the Shopware Deployment Helper, ensure plugin:install runs in your pipeline.
  • Build storefront assets when a plugin ships storefront changes: bin/console theme:compile (and ./bin/build-storefront.sh in a full deploy).

Verify it's active

Open Extensions → My extensions — the plugin should show a green Active toggle. Plugin-specific settings then appear under Settings → System → Plugins.

Licensing

SSD plugins are distributed through the Shopware Store as a monthly subscription. Your license is tied to your Shopware account and the sales channel domain registered with it. A lapsed subscription disables the plugin but never deletes your data — the plugin's data is preserved and resumes working when the subscription is renewed.

Your Vision. Signed, Sealed, Delivered.