Translate Product Data

General

You can use the create attribute translations endpoint to create new or update existing simple attribute translations.

Translations for advanced attributes are provided with the respective entity itself.

Admin API

Create Attribute Translations

When you work with attribute translations, you can only create and update simple attributes with this endpoint. Simple attributes contain clearly defined single values, e.g., size or color options.

About this Method

The method is used to create new or update existing simple attribute translations.

Method Signature

JavascriptPHPcURLJava

Copy

adminApi.apis.Translations.updateOrCreateAttributeTranslations({attributeName: attributeName}, {requestBody: translations});

Details

The provided value must include a translation for the default system language. It is used to resolve an existing attribute value you wish to add translations for. This means, that it is not possible to add translations for an attribute, which has not been yet created via the product creation or a similar endpoint.

Create Attribute Translations

JavascriptPHPcURLJava

Copy

let translations = {
    de_DE: "weiß",
    en_GB: "white"
};

adminApi.apis.Translations.updateOrCreateAttributeTranslations({attributeName: "color"}, {requestBody: translations});

Get a Collection of Attribute Translations

You can not only retrieve translations for single simple attributes. By extending your query, you can also get multiple translations.

About this Method

This method can be used to get a collection of translations for an existing simple attribute.

Method Signature

PHPcURLJavaJavscript

Copy

$translationCollection = $adminApi->attributeTranslations->all(string $attributeName);

Parameters

Examples

JavascriptPHPcURLJava

Copy

let response = await adminApi.apis.Translations.getAttributeTranslations({attributeName: "color"});
let translations = response.body.entities;