First Run Wizard

The First Run Wizard is launched automatically as soon as the installer logs you into the admin interface for the first time after the successful installation.
The wizard will help you to set up your shop step by step.
You can also access the First Run Wizard at any time after setup. To do this, navigate to Settings > System > First Run Wizard. If you open this, you can make or change the initial settings explained below.

Installing the language pack

The first step, the wizard offers you to install a language pack containing mulitple languages. Click on the Install button to add the language pack.

After completing the installation you can change the language of the administration interface by selecting the desired language from the drop down menu.

If you change the language at this point, it will only affect the language within the administration interface and only for the currently logged in user. You define the languages of your sales channels (such as the storefront) in the configuration of the respective sales channel.
Once you have installed the language pack, click the Next button to proceed to the next step.

Data import

The next step gives you the opportunity to add some demo data such as first products, categories and manufacturers. Click Next if you want to use the demo data. Alternatively, you have the option to install the migration wizard.

The demo data is for testing purposes only. You should not use it in a production environment. Click Skip if you don't want to use the demo data.

Default values

You can later create several sales channels in your Shopadmin. All sales channels that you set up as default on this page are automatically linked to newly created products. This will save you the work of having to do this manually later in a new product. You exclude shops in which you do not want to offer all your products.

If you have several sales channels, you can open this window via the Set visibility for selected sales channels link. These three setting options are available:

  • Visible (default) - with this selection, the product is always visible to customers in the shop.
  • Hide in listings - Your customer will not see the product in your shop, but if they have placed the specific product in the shopping basket in one of your other sales channels, it will remain and can be purchased. In addition, your customer can use the search function to select the product directly.
  • Hide in listings and search - the product is neither visible in the storefront nor can it be found via the search.

Mailer configuration

Here you have the possibility to configure the mailer settings for receiving and sending e-mails.
If you want to configure the mailer settings at a later time, click on Set later.
A more detailed explanation about setting up the mailer can be found the documentation, located here.

PayPal Configuration

In the third step of the first run wizard you can enter your PayPal API access data, which will then be saved in the plugin.

As soon as you click on the Configure button, a new window appears in which you can enter your PayPal API access data. Here you can also select whether PayPal should be saved as the default payment method. If you select this option, PayPal will be saved as the default payment method in all existing sales channels. This setting can be changed again later for each sales channel.


In the second to last step of the first run wizard you have the possibility to install a selection of useful plugins for your shop. To do this, first select the region that is relevant for you. Afterwards you can browse through different categories.
In the Tools category, for example, you'll find our Migration Assistant to make the transition from Shopware 5 to Shopware 6 easier.
Click on Next when you have installed all the plug-ins you are interested in to get to the final step of the setup.

Your Shopware account

In the last section you are able to set your Shopware account. This will give you access to your purchased plugins and licenses. You can also use it to access other Shopware platforms such as the Community Store or the forum. If you don't have a Shopware ID yet, you can register here.

Once you have entered your Shopware ID and password, click on the Next button to link your Shopware 6 verified domain to this shop. Select your preferred domain from the list of verified domains and click Next.

The domain link is used to ensure that the domain is uniquely assigned to a Shopware account. This is necessary in order to be able to obtain extensions for your shop. The Shopware account is your central platform for interacting with Shopware AG. You can use it, for example, to manage the rental of extensions or support subscriptions. You can find more information about the Shopware account in this documentation.

With the help of the button create a new shop domain you can also create a new domain. If this is a Test environment, you can indicate this by clicking in the checkbox.
It should be noted that the domain entered here must already be externally accessible and that the web server must refer to the public-Directory within the Shopware 6 installation. Domains created via the First Run Wizard are stored as a Community Edition in your Shopware account.

This completes the initial setup by the First Run Wizard. Click the Finish button to end the First Run Wizard.

Was this article helpful?