Shop Settings - General

Basic Information

Here you can store all of the general information about your shop. These will be used later in different places in the shop, e.g. in email templates.

How to use these variables in emails is described in the article Email templates.

Description of the particular fields

Shop name: Enter the name of your shop here, this field is used for the page title and various other places.

This field is only used, if you didn't provide a name in the shop settings

Shop owner email: Various confirmation and status emails will be sent from this address (new orders, new customers, etc). You can also receive e.g. order notifications through this.

Address: Enter your business mailing address here.

Bank information: Here you can fill in your shop's bank account credentials, which then are used in order confirmation mails, if your customer chose prepayment as the payment method.

Company: Enter the complete name of your company here.

Shop is family friendly: This setting sets the metatag "isFamilyFriendly" for search engines.


Here you are able to quickly define new currencies for items offered in your frontend. Existing currencies are displayed in the middle column and new currencies can be easily added.

Existing currencies must not be deleted. New currencies can be added and existing currencies may be modified.


  • Name: This is simply the name of the currency.
  • ISO: This is the ISO code of the currency (displayed in the frontend for currency exchanges).
  • Symbol: This is the currency symbol for display in the frontend.
  • Symbol position: Here you can set whether the currency symbol appears before or after the amount. For a dynamic integration, a standard setting is recommended.
  • Factor: The exchange rate of the currency against the value of the euro (EUR = 1).
  • Position: This sets the position of the currency in the frontend selection.

  • Using currencies in your shops

To use the currencies in the desired shops, open the shop settings in Configuration > Basic settings > Shop settings > Shops, choose the desired shop and add the currency in the field "Select currencies" in the regarding shop.


In the "basic settings > shops" you can add the new currency to preferred shop shops.


Under Configuration/Basic settings/Shop settings click on Localizations.

Here you find all available localizations with the corresponding ISO codes. You should not change anything in these entries. The translations are automatically assigned in the frontend, based on the localization function (e.g., the label on the PayPal Express buttons).

If the country is missing from the list, you can add it, naturally, with the "Add" button. When adding a new country, you have three text fields to fill. 


Set the language. For example "Spanish" 


Specify the country or region. For example "Argentina" 


Enter the valid ISO code. For example "es_AR" 


With the Tax management you can create and assign different tax rates for different countries. The tax management can be found in Configuration > Basic settings > Shop settings > Taxes

The addition takes place on the systems net price. The gross price depends on the used tax rate, which depends on the customers shipping country.

Please bear in mind that all prices are stored as net prices in the database. This means that the defined tax rate of the country is added to each net price. So if you have defined different tax rates per country, the gross price in the frontend will also change accordingly as soon as the country is changed. Cross-country, uniform gross prices cannot be mapped by default in Shopware.


  • Tax rate for germany = 19%
  • Tax rate for austria = 20%

The item which costs 11,90 € for a german customer (net 10,00€ + 19% tax) will cost 12,00€ for a austrian customer (net 10,00€ + 20%)

These tax rate can be configured individually for every customer group, country and state.

Never delete the default tax rates, otherwise this can cause in misfunction. When needed, you can configure this tax rates individually or create new tax rates. The default tax rates can be found in the database table s_core_tax and have the id 1 and 4.

Tax group

In the middle column of the module you can find all tax groups, by default there are 2 tax groups, normal tax (named 19% for example) and reduced tax (named 7% for example).

Add a tax rate

You can add as much tax groups as you need and inherit these groups to your desired countries. In the most cases only 2 tax groups (reduced, high) are necessary.

Delete tax group

By clicking delete entry the complete tax group with all its assigned tax rules will be deleted.

Tax rules

In the right column of the module contains all configurations of the selected tax group. Here you can set individual tax rates per customer group / country / state.


Just give your tax rate a name.

Default tax rate

Here you can define the default tax rate, e.g. 19%

Tax rules

here you can define rules for your tax group, every customergroup / country or state can get a different tax rate. If no individual or inherited tax rate will be used, Shopware automatically falls back to the default tax rate of your tax group.

Choosing the customer group

Choose the customer group first, then you can click add entry to define individual tax settings.

Naming of tax rules

By clicking Name you can enter your desired name for your tax rule.


Here you have to choose the area, in which this rule should work. This area depends on the area-setting in Configuration > Basic settings > country areas.


Here you can define the country in which your tax rate should appear. In this Dropdown you only see countries in the before chosen area. Choosing all your rule will appear in all countries of the selected area.


If you want your tax rule to grep only in specific states, you can define this here, base on the chosen country you can define a state here in which you want to activate this tax rule. Defining states is made in the country settings in Configuration > Basic configuration > Shop settings > Countries.


Here you'll define the tax rate which will appear dynamically in the frontend depending on its rules.


As of 01.07, the One Stop Shop sales tax applies to the EU.

Does the EU OSS apply to you?

As of July 1, 2021, there is a new EU threshold. This threshold is 10 000 €. If you exceed this threshold, you must register in the respective online OSS portal.

What does that mean for you?

The store should clearly show the delivery country for which the displayed prices apply. Likewise, you should be able to easy choose the delivery country with the respective prices in the store.

If you want to learn more about the new threshold, you can find more information here.

What needs to be done?

Under Settings > Basic Settings > Storefront > Shopping Cart / Item Details you have the option to show the shipping cost calculation in shopping cart (1) and shipping cost calculation in mini/offcanvas shopping cart (2). As soon as the options are set to "Expanded" you will see the delivery country, payment method and shipping method.


Country selection

With the Countries tab you are able to add all regions, countries and associated states which are managed in your shop. These entries are used, for example, for assigning individual tax groups, shipping types and costs, and/or required for risk management functions.

First you see a list of all areas that have already been created with the assigned areas (see also the info on the countries zones) and also the stored ISO code.

Adding regions & countries

With the Add entry button, you have the option of adding new countries.


  • Name - country name (e.g., Deutschland)
  • International name - e.g., Germany
  • Active - country active within the selected area (yes/no)
  • Area - selection of previously created areas
  • Iso (alpha-2) - country code according to ISO 3166 (e.g., ES))
  • Iso (alpha-3) - 3-character ISO country code (e.g., ESP))
  • Position - number/position in the shop
  • Description
  • Free of shipping costs - all deliveries to this country are free of shipping costs
  • Tax free - deliveries in the country are tax free
  • Tax free for companies - tax-free if the customer entered a valid VAT ID

    The VAT check must be activated with the VAT ID check plugin.

  • Display state selection - the option to display the selected state in the frontend
  • State selection required - a state must be selected in the frontend

Adding states

Optionally all countries can be divided into states. These following fields are required:

  • Name of the state - e.g., Colorado
  • ISO - e.g., CO
  • Position - number/position in the shop
  • Active - state active within the selected area (yes/no)
  • Delete entry - the state will be completely deleted
  • Translate - clicking the globe allows you to enter a corresponding translation for the state

Geo blocking - disable shipping in specific countries

In Shopware you can disable shipping in specific countries even when you allow registering for those. For this you deactivate the checkbox Allow the usage as shipping country: (1).

If now a customer registers for this country and does not give an altering shipping address he gets the notification "The selected country is not available for shipping. Please select another shipping address" in the checkout.

Deleting countries

In the middle column, select the country you wish to delete. All available areas in the country will be displayed. Simply make your selections and then click the button to delete.


By using the translation symbol (1) you can change the country settings for subshops individually.

Please mind that this setting is only working if you have entered a translation in the field name (1). If you for example do not want to offer a country in a subshop you have to translate the country name first, otherwise the option active has no effect.

Country areas

Under Configuration/Basic settings/Shop settings click on Country areas.

Here you can create groups and assign areas and countries to them. You can easily combine several countries into one group (e.g., Europe) to allow for fast and easy management of many countries at once.

If areas are removed, the associated countries are also deleted!

Was this article helpful?