You can configure the countries of your shop in Admin under Settings > Shop > Countries.


In the overview you will find all configured countries that are currently available within your languages in your sales channels.

First you need to select the language (1). The overview gives you information about the available countries.

In the first column you can find the configured countries (2). The next column shows you which position (3) the respective country has in your storefront. Furthermore the column ISO (4) shows you the country code according to ISO 3166 (e.g. DE) and the column ISO3 (5) the 3-digit ISO country code (e.g. DEU). In the column Active (6) you can either activate or deactivate the respective country. The column List view (7), which is displayed here with three dots, allows you to make further settings within the table view. So you can choose for example which columns are displayed or in which order they should be displayed.

Country settings

By clicking on the button Create country, which is located in the upper right corner of the overview, you can create a new country for your store. In the Settings tab you will find the two areas General and Options.

New data is always entered in the default system language.


Name (1): Enter the name for the country here.
Position (2): If you want to keep a certain order in the selection of the countries, you can achieve this by the position. 
ISO2 (3): Enter the country code according to ISO2.
ISO3 (4): Enter the country code according to ISO3.


Active(1): With this button you activate or deactivate the country for the customer in your store.
Shipping(2): This button will activate or deactivate the availability to ship products to this country. If this option is deactivated customer will get the following message when they try to select it "Deliveries to the selected delivery address are not possible".
Tax-free (B2C) (3): The option Tax-free offers you the option to offer the deliveries to the respective country tax free. You can either activate or deactivate the option. If this option is enabled, the products are already displayed tax-free in the listing, on the item detail page, in the shopping cart and in the checkout.
Min. cart value (net) (4): This option is available if you have enabled tax free. Here you can specify from which value in which currency an order for this country is tax-free for B2C customers.
Currency dependent value (5): If you also offer other currencies in your store, you can also set the tax-free limit for the other currencies here.
Tax-free (B2B) (6): This option offers you the same possibilities as Tax free (B2C) only for business customers. Here, too, you can set an amount for each currency, from which point the order becomes tax-free. In order for B2B transactions to be tax-free, the respective customer accounts must have a valid VAT ID.
Validate VAT Reg. No. format (7): If you activate this switch, you can activate a check of the VAT ID format, this is possible for countries of the EU. For other countries the check is not available.
VAT Reg. No. required (8): Specify here if the specification of a VAT ID is a mandatory field for this country.
State/region required (9): If you require the specification of a federal state for a country, you can activate this via this option. In this case, it is necessary that you store the federal states accordingly. This is possible via the tab States/regions. You will find more information about this in the next section States/region.

New data must always be entered in the default system language.


To configure the states and regions, click the States/Regions tab at the top. Here you can edit the states/regions or create a new one using the Add states/region button. A pop-up window will open where you can assign the name, the ISO code and the position of the state.

All information that is displayed in the country overview can also be changed directly there. Simply double-click on one of the entries. This opens the edit mask of the respective entry. You confirm the information with the blue arrow on the right side.


If you want to make further settings for the validation of the countries/federal states, you can do this under address management.

Address markup


Was this article helpful?