Skip to content

Multilingual markets

Sites available in multiple languages does not require multiple markets with individual data feeds to cater for different languages. A market can be served by one data feed that includes data for multiple locales. When connecting several locales to a market, the site will use the same behavioral data regardless of the selected language of the visitor. This also allows for easier merchandising for retailers.

Requirements

Each market corresponds to a specific set of SKU:s made available for e-commerce. Multiple locales can be used to provide translations of SKU properties on a market. The exact same inventory must exist for all translations, meaning that the set of keys for product groups, products, variants must be identical across all locales within a market. The structure within the data feed must also be the same between the locales, e.g. a product must belong to the same product group in all locales, and a variant must belong to the same product in all locales.

In addition to the structural requirements, the following attributes (if used) must be equal in all locales:

Element Attributes
Product group supress_duplicates
Product color_override, color_default, release_date, rating, style_with
Images type_default, type_override, width, tags, urls (the combination and order of all url attributes)
Variant cost, list_price, selling_price, stock_number
Custom prices id, list_price, selling_price
Stores key, stock_number
Content type

Note that the id attributes for custom prices and the key attributes for stores must be the same for all locales.

Locales must be consistent at all times. If a new locale is to be added to a market, all products must be present in the import that introduces the new locale. In order to specify multiple locales in the same import, use multiple Modify tags with the same market key.

Attribute modifications may only contain price and stock modifications on markets with multiple locales. The exact allowed attributes are: selling_price, list_price, cost and stock_number. This includes those attributes for stores and custom prices.

Import example

The following example will add items to a site with the market set to FI and the locales set to sv-SE and fi-FI.

Multilingual market file syntax example
<?xml version="1.0" encoding="UTF-8" ?>
<data_import type="full">
    <modify market="FI" locale="sv-SE">
        <product_groups>
            <add_or_replace>
                <product_group key="1001">
                    <brand>Gazelle</brand>
                    <department>Män</department>
                    <products>
                        <product key="1001-100">
                            <title>T-shirt i linne</title>
                            <url>/products/1001-100</url>
                            <release_date>2019-10-27T00:00:00Z</release_date>
                            <description>Randig T-shirt med lös passform med lite lägre halsringning.</description>
                            <images>
                                <image>
                                    <urls>
                                        <url>//cdn.elevatedrivensite.com/images/1001-100_model.jpg?preset=200x200</url>
                                        <url>//cdn.elevatedrivensite.com/images/1001-100_model.jpg?preset=600x600</url>
                                    </urls>
                                </image>
                                <image>
                                    <urls>
                                        <url>//cdn.elevatedrivensite.com/images/1001-100_cutout.jpg?preset=200x200</url>
                                        <url>//cdn.elevatedrivensite.com/images/1001-100_cutout.jpg?preset=600x600</url>
                                    </urls>
                                </image>
                            </images>
                            <custom_attributes>
                                <season>Sommar</season>
                                <style>Casual</style>
                                <category>T-Shirts</category>
                            </custom_attributes>
                            <variants>
                                <variant key="1001-100-1">
                                    <stock_number>12</stock_number>
                                    <selling_price>9.99</selling_price>
                                    <list_price>12.99</list_price>
                                    <cost>8.00</cost>
                                    <url>/products/sv/1001-100?size=liten</url>
                                    <sizes>
                                        <size>liten</size>
                                    </sizes>
                                </variant>
                                <variant key="1001-100-2">
                                    <stock_number>0</stock_number>
                                    <selling_price>9.99</selling_price>
                                    <list_price>12.99</list_price>
                                    <cost>8.00</cost>
                                    <url>/products/sv/1001-100?size=stor</url>
                                    <sizes>
                                        <size>stor</size>
                                    </sizes>
                                </variant>
                            </variants>
                        </product>
                    </products>
                </product_group>
            </add_or_replace>
        </product_groups>
        <content_items>
            <add_or_replace>
                <content key="871">
                    <type>link</type>
                    <title>Frakt</title>
                    <link>/fi/kundtjänst/frakt</link>
                </content>
                <content key="872">
                    <type>link</type>
                    <title>Kontakt</title>
                    <link>/fi/kontakt</link>
                </content>
            </add_or_replace>
        </content_items>
    </modify>
    <modify market="FI" locale="fi-FI">
        <product_groups>
            <add_or_replace>
                <product_group key="1001">
                    <brand>Gazelle</brand>
                    <department>Miehet</department>
                    <products>
                        <product key="1001-100">
                            <title>T-paita pellavaa</title>
                            <url>/products/1001-100</url>
                            <release_date>2019-10-27T00:00:00Z</release_date>
                            <description>Raidallinen T-paita löysällä mallilla, jossa hieman matalampi pääntie.</description>
                            <images>
                                <image>
                                    <urls>
                                        <url>//cdn.elevatedrivensite.com/images/1001-100_model.jpg?preset=200x200</url>
                                        <url>//cdn.elevatedrivensite.com/images/1001-100_model.jpg?preset=600x600</url>
                                    </urls>
                                </image>
                                <image>
                                    <urls>
                                        <url>//cdn.elevatedrivensite.com/images/1001-100_cutout.jpg?preset=200x200</url>
                                        <url>//cdn.elevatedrivensite.com/images/1001-100_cutout.jpg?preset=600x600</url>
                                    </urls>
                                </image>
                            </images>
                            <custom_attributes>
                                <season>Kesä</season>
                                <style>Casual</style>
                                <category>T-Shirts</category>
                            </custom_attributes>
                            <variants>
                                <variant key="1001-100-1">
                                    <stock_number>12</stock_number>
                                    <selling_price>9.99</selling_price>
                                    <list_price>12.99</list_price>
                                    <cost>8.00</cost>
                                    <url>/products/fi/1001-100?size=pieni</url>
                                    <sizes>
                                        <size>pieni</size>
                                    </sizes>
                                </variant>
                                <variant key="1001-100-2">
                                    <stock_number>0</stock_number>
                                    <selling_price>9.99</selling_price>
                                    <list_price>12.99</list_price>
                                    <cost>8.00</cost>
                                    <url>/products/fi/1001-100?size=lso</url>
                                    <sizes>
                                        <size>lso</size>
                                    </sizes>
                                </variant>
                            </variants>
                        </product>
                    </products>
                </product_group>
            </add_or_replace>
        </product_groups>
        <content_items>
            <add_or_replace>
                <content key="871">
                    <type>link</type>
                    <title>Laivaus</title>
                    <link>/fi/asiakaspalvelu/laivaus</link>
                </content>
                <content key="872">
                    <type>link</type>
                    <title>Yhteydenotot</title>
                    <link>/fi/yhteydenotot</link>
                </content>
            </add_or_replace>
        </content_items>
    </modify>
</data_import>

The following example attribute modification will lower the stock of the 1001-100-1 variant to 11.

Attribute modification example
<?xml version="1.0" encoding="utf-8" ?>
<attribute_modification>
    <modify_attributes market="FI">
        <variants>
            <variant key="1001-100-1">
                <stock_number>11</stock_number>
            </variant>
        </variants>
    </modify_attributes>
</attribute_modification>
×
Copyright

This online publication is intellectual property of Voyado Lund AB. Its contents can be duplicated in part or whole, provided that a copyright label is visibly located on each copy and the copy is used in conjunction with the product described within this document.

All information found in these documents has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Voyado Lund AB nor the authors shall be held liable for possible errors or the consequences thereof.

Software and hardware descriptions cited in these documents might be registered trademarks. All trade names are subject to copyright restrictions and may be registered trademarks. Voyado Lund AB essentially adheres to the manufacturer’s spelling. Names of products and trademarks appearing in this document, with or without specific notation, are likewise subject to trademark and trade protection laws and may thus fall under copyright restrictions.

CLOSE