First Steps - 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.

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.

Shopware Markets

The Shopware Markets extension offers you the possibility to offer your products outside of your shop on the eBay and Amazon marketplaces.


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?