Overview

This article explains how to structure and send a product catalog when your website supports multiple languages. This setup ensures that each product is correctly identified and displayed in the appropriate language across integrations.

Catalog feeds by language

To ensure data consistency, send a separate catalog feed for each language. Most fields vary depending on the language, including:

• Additional fields (extras)
• Categories (categories must have the same IDs as the default catalog)
• Description
• Product page URL
• Product title

Each feed must contain translated information specific to that language. For a complete list of catalog attributes and their requirements, see Product catalog attributes.

Example feed organization

A typical structure uses separate files for each language version:

• catalog_de.csv for German catalog
• catalog_en.csv for English catalog
• catalog_fr.csv for French catalog

Each feed contains the same products, but the information is adapted to the corresponding language.

Best practices

To ensure the multilingual catalog works properly, follow these guidelines:

• Ensure that each feed contains only one language.
• Keep the same product ID across all languages.
• Keep translations up to date when product information changes.
• Verify that URLs point to the correct language version of the website.

Alternatives

If your catalog contains all products in different languages and you cannot separate them into different feeds, you must specify the language for each product within the catalog. Use the ISO 639-1 two-letter code format (for example, en, fr) to specify the language.

Example