Setting up the Store for Switzerland in German and French

Please note this is only valid Shopware 6.2.0 to 6.3.5.3 using the individual language pack.
For Shopware 6.3.5.3 with the new Shopware language pack and Shopware 6.4 please continue here.

To get started with Shopware 6, download the latest version that can be found here.
Once that is done, please follow the instructions that can be found here to deploy Shopware.

Translation

Shopware is available in many languages, if you want to contribute you can do so on Crowdin by clicking here you are redirected to our Crowdin Shopware 6 page. 

Installation

Please note that the selected language is only for the installer.
In this guide we will show how to setup the for Switzerland in German and French, the languages can be changed to any language offered.

Pick the desired language from the drop down menu (1) and click Next (2).
Since we chose German, the menu will be in German.
Make sure that your system fulfills the system requirements and click Next.
Read and accept the general terms and conditions and click Next.
Enter the requested information about your database and click Next.
 

It's recommend to use English or German as the system default language.
We are using German as the system default language (1) and we are adding French by installing and activating the corresponding language plug-in in the next step.

Remember to set your default currency (2) this is important as it's used as a base for calculating different currencies.
After the installation, you can change the language in the Admin area for the complete store.
Fill in all required fields, and click Next (3).
If everything has been setup right you should now be presented with the login screen for the admin area.

First run wizard in the Admin

If the admin login does not show for a reason, you can call this by using www.mystore.com/admin.
You will be greeted by the first run wizard. Since we picked German as the default language the admin will be shown in German,
Please note that we used English instead of German for this guide.

Install the language pack (1) that you need and click Next (2). In this guide we will install the French language pack. Proceed through the first run wizard until done.
Navigate to Settings > System > Plugins and make sure the required language pack is installed and activated.
 

Changing the Admin language

If the admin login does not show for a reason, you can call this by using www.mystore.com/admin.
You will be greeted by the first run wizard in German. In the next step we are showing you to change this to French. Every administrator can use the language that they prefer as long as it's installed, English and German are default system languages so these are always available.
Navigate to Administrator, expand and click your profile.

Set the User interface language (1) to the language that you desire and click Save (2)
Your admin area is now displayed in the language of your choice as seen below.

Please note that we changed the User interface language back to English for this guide.

 

Changing the store language

Up until this point, only the Admin area is shown in your desired language, the webstore it self remains unchanged. We are going to change this now.
 

Navigate to Sales channel of choice (1), add all countries (2) that you plan on using under this sales channel. Set the default country (3) to your primary country in this case the Switzerland.
If you want to add more than one currency to the sales channel add these to the currencies (4), and set the default currency (5), in this case it's Swiss francs.
Change the available language (6) to match all languages that you wish to display in this sales channel, we added German and French. Change the default language (7) for this channel to German and click Save (7).
If you have more than one sales channel remember that these settings are only applied to the selected sales channel.

Adjust the domain

We are now adjusting the domains so that we the store will show a German and French page.

In the section domain, we start with ... (2) where we select edit domain, here we need to change the currency to Swiss francs, once this is done click add domain (1) to add a sub domain for the French store front.

Make sure that the url (1) is right. Check the Language (2) and associated Snippet (3) as desired. Change the Currency (1) to Swiss francs and click Edit domain (4). These settings are important and will only be available for this domain.
Make sure to setup the domain for http and https and that these have the same settings.

Back in the overview click add domain.
 

Add the url (1) we added /fr to indicate that this is pointing to the French language.
Set the Currency (1)Language (2) and associated Snippet (3) as desired and click add domain (5). These settings are important and will only be available for this domain.
Make sure to setup the domain for http and https and that these have the same settings.

Verify all previous settings under General settings and the Languages and Snippet set under domains (1), if all are showing the settings click Save located at the top of the page.
If there are any default translations that don't meet your expectations these can be changed under Settings > Snippet.

If you take a look at the store front you should see that there is a drop down menu in the top right.
This is where your customers can change the language of the store front.

Tax

We need to update the tax rates to reflect so these are valid for this country. This can be found under Settings > Tax.
 

Click on the ...(1) next to the tax rate that you want to change, this will open up a new mask.
 

Give your tax a Name (1) and enter the Default tax rate (2). The default tax rate is your fallback if nothing else is defined. You can define a tax rate for countries by clicking Add country (3). If you are done click save (4).In this example we will setup the tax rate for the Switzerland which is 7.7%.

We changed the 19% default rate to 7.7%, and we added the Switzerland and Germany.
Adding the Switzerland is not needed because the tax rate matches the default rate.

Choose a country (1) from the drop down list, set the tax rate (2) and choose whenever this applies to (3) the entire country, a zip code or a state. Save (4) your settings once you are done.
 

You will now see the default tax rate (1) added countries (2) with their
set tax rate. If every thing is as desired click save (3).
 

Adding custom pages

In this section we will explain how you can set up the footer from scratch.
The first thing that we need to do is add some categories, this needs to be done under Catalogues > Categories. How to set up a new category is explained here
Please make sure to pick a name that indicates what content can be found in the section, because the name will show up in the frontend
 

We add a new first level category (1) called Footer Navigation, after saving this we add two sub categories (2) Shop Service and Information, these are added in the shop system default language. The language is shown in the drop down menu (3).

Now select the French language from drop down menu (1). We can skip the first level category called Footer Navigation. Click on one of the added sub categories (2). The name (3) is displayed in a lighter tone, this indicates that it's not yet translated and will fall back to the system default language. After translating the name (3), click save (4) and continue to the next sub category
 

Now we have our basic category structure, we need to assign this as a entry point for our shop. First we select our Sales Channel (1), next we need to define the Entry point footer navigation (2).
In the drop down menu select Footer navigation, the one that we just created and click Save (3).

Now we are ready to create the shop pages that we want to show in the frontend under the appropriate section. In order to do so please navigate to Content > Shopping Experiences and create a new shop page. 
Information about shopping experiences and how to create them can be found here.
 

In this case we will create and add the shop page Shipping cost, we can translate this page and don't need to create a new page for every language.
 

After you are happy with your layout, save (2) the page and switch to the French in the drop down menu (1).
 

After you are happy with your translation click on save in the top right corner.
 

Head back to Catalogues > Categories.
Create a sub category under one of the previously created sub category Information.
Verify that you are working on the Dutch language.
Name this shipping costs, and assign the layout that we just created in the last section.
Now you need to make sure the sub category is active and click Save.

To make sure every works as intend please navigate to the frontend of your store and take a look at the footer, you should see your newly created pages.

Landing page

Just like we created the shop pages for our footer we are going to create a landing page. We can do a lot with the shopping experiences so that it stands out.
Please navigate to Content > Shopping Experiences and create a new landing page. Information about shopping experiences and how to create them can be found here.
 

In this case we will create and add the landing page Homepage.

After you are happy with your layout, save the page.

Remember to use the button in the top right corner to switch between the languages that you use in your shop and translate these accordingly.

n order to tie the landing page to the right category we navigate to our Sales channel (1), here we take a look at Entry point main navigation (2). This tells us where the customer will enter the site, thus telling us to which category we need to add the landing page.

Head back to Catalogues > Categories. Click on the category that's set as your entry point. Change the layout to the created landing page, confirm and click on Save.

To make sure every works as intend please navigate to the frontend of your store and take a look at landing page.

Optional changing the demo data

categories and Products

Please note that these steps only apply if you have chosen to install the Demo data.
If you take a look at the frontend of your webstore you will notice that everything is in the desired language except the Demo data. To change this we need to go back into the admin area.
Navigate to Catalogues > Categories and pick a category that you want to translate.

Select the language from the drop down menu (1) that you'd like to add, in this case it's Dutch.
Notice that the name is displayed in grey (2), this means that it will fall back to the store default language which is English in this case. Enter the translated name for the category and click Save (3). The same applies to Products, these need to be translated or they will fallback to the default store language.
If you used the Demo Data there is something else that you will need to translate.

Product properties

As you can see these are still in German. We need to translate the Properties and Property values.
To translate a property click the ... on the right-hand side.

Select the language from the drop down menu (1) that you'd like to add, in this case it's Dutch.
Notice that the name is displayed in grey (2), this means that it will fallback to the store default language which is English in the case. Enter the translated name for the property and click Save (4).
The same applies to Property values (3), these need to be translated or they will fallback to the default store language.

Was this article helpful?