Skip to content

Extension Management

Extension Management

Normally all extensions installed by the Administration will be stored inside custom/plugins or custom/apps. When you want to update extensions, you have to re-upload the zip file or download the extension from the store using the Extension manager in the administration.

This way of extension management brings many problems:

  • It is hard to keep track of which extensions are installed and in which version
  • The extensions can be modified live in the Administration without version control
  • Extension updates must be downloaded manually for each extension and installed
  • Extension updates in the Administration can't be done together with Shopware updates
  • Composer class loader cannot be optimized because we need to dynamically look up into custom/plugins

Installing extensions with Composer

To solve these problems, it is recommended to install all extensions (plugins and apps) with Composer. This way, you can manage all extensions in one place and update them along with Shopware. To get started with Composer, first, you need to authorize your local project with the Shopware Composer Registry. Below are the steps:

  • Login to and go to your Shop (in Merchant or Account area)
  • Click on one extension
  • Click the button "Install via Composer"
  • Generate a token and save it

Now you can add the Shopware Composer Registry to your project:

composer config repositories.shopware-packages '{"type": "composer", "url": ""}'

composer config <your-token>

After that, you should have a newly created file auth.json, in your project root. This file contains your token and is used by Composer to authenticate against the Shopware Composer Registry.


The auth.json should not be committed to the repository and should be ignored by default with the .gitignore file.

Now you can install extensions with Composer:

composer require{extension-name}

This downloads and extracts the extension package into the vendor directory. To install and activate the extension in Shopware, execute the following console command:

bin/console plugin:install --activate <extension-name>

You can also find the Composer package name when you click "Install via Composer" in the Shopware Account.

Migrating already installed extensions to Composer

If you already have extensions installed in your project, you can migrate them to Composer. First, you should install the extension with Composer:

composer require{extension-name}

And then delete the source code from custom/plugins/{extension-name} or custom/apps/{extension-name}.

After that, you must run the below command for Shopware to detect the installed extensions per Composer.

bin/console plugin:refresh

Enabling Composer class map authoritative

When all extensions are installed with Composer, you can enable the Composer class map authoritative. This will improve the performance of the class loader and is recommended for production environments. The class map authoritative, disables the live class lookup when it cannot find the class in a dumped class map.

    "require": {
        "shopware/core": "....",
        // .....
    "config": {
        "optimize-autoloader": true,
+       "classmap-authoritative": true

And run the below command to re-generate the class loader.

composer dump-autoload