Managing Products in Multiple Countries and Languages

In some instances, you may need to upload products intended for specific countries such as Switzerland, Germany, or the US. This is possible without the need for creating a separate Supplier Store and can be done via the existing product onboarding process. When a catalogue is uploaded, pricing can be provided for multiple countries by creating further price lists for the product or variant.

Additionally, you may wish to provide the product information in the languages of each country you are uploading for. This can be achieved by making use of the language_code parameter.

1. Identify the products you would like to make available in different countries.

2. Create price lists for the relevant products in the desired countries.

1. Identify the products you would like to make available in different languages.

2. Set the language code in the product import file to the desired language and fill out the relevant fields.

1. Import the products you would like to make available in different countries, optionally importing the information with different language codes if it is available in the corresponding languages.

2. Create price lists for the products in the desired countries.

• Products can be imported in different languages to create translations. The default language for products is English.
• If you have your product information available in e.g. German, you can import with the language specified as German. These products will then become available in German, and will also be translated to become available in English.
• If your products have already been imported in English or any other language, then you can import new translations by using the same product or variant identifiers but with the inclusion of the appropriate language_code e.g. de.
• The German lanuage versions of products will then automatically be used for selling to Germany. The English versions will be used for selling in any other country that does not have product information supplied in the language for that country.

The default language_code for creating a product or variant is English (en). If your product information is in English then you do not need to provide this field.

• If this is the first time importing these products, then simply include the language_code field and the relevant value (e.g. de) to let the system know that the product information is in German. As a part of the import process, default English translations will be automatically created alongside the provided language.
• If you have already imported these products in English or any other language, then be sure to use the same product or variant identifiers for the new translations so that they can be correctly matched. Then simply include the language_code field for the new language and the relevant value e.g. de.

The default language_code for creating a product or variant is English (en). If your product information is in English then you do not need to provide this field.

If the product you are creating is in a different language such as German, or you wish to provide a translation for an existing product, then when using the create product or create variant endpoints, the language_code field must be included in the product object within the request body with the appropriate value for that language e.g. de.

{
  "name": "Product Name in German",
  "language_code": "de",
  // The rest of the product information in German
}

If the product needs to be updated for a particular language, then the update product and update variant endpoints can be used with the inclusion of the language_code field in the product object within the request body.

{
  "name": "New Product Name in German",
  "language_code": "de",
  // The rest of the updated product information in German
}