Translate features, attributes and brands
ps_translate_catalog_items
Translates feature names and values, product options such as colours and sizes, and brand and supplier descriptions into another language.
Free TellMyShop Audit: No. This tool is only in the paid version of TellMyShop. The free TellMyShop Audit has only tools that read your store.
Ask Claude
„Translate all colours and sizes into German.”
Example preview
Type attribute, language de, 14 items. 12: "Black" -> "Schwarz". 13: "White" -> "Weiß". 21: "Navy" -> "Marineblau". Sizes S-XXL: unchanged (same in both languages).
Technical details
Translates the catalogue dictionaries: type=feature (feature names, for example Material), feature_value (values, for example Cotton), attribute_group (attribute groups: name in the back office, public_name in the shop), attribute (Red, XL), manufacturer and supplier (descriptions and meta). action=list shows texts in the source language (source_lang, default the shop's default) and the target language (lang); only_missing=true (default) shows only empty ones or ones identical to the source. action=update writes up to 200 translations at once (items: id + fields). Products and categories are translated with ps_update_product_content and ps_update_category_content.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| action | enum: list | update | yes | list | update. |
| type | enum: feature | feature_value | attribute_group | attribute | manufacturer | supplier | yes | Kind of catalogue dictionary. |
| lang | string | yes | Target language of the translation (ISO, for example en). |
| source_lang | string | no | list: source language (default the shop's default language). |
| only_missing | boolean | no | list: only missing translations (empty or identical to the source language). Default true. |
| limit | integer | no | Maximum rows (default 100, max 500). |
| offset | integer | no | Rows to skip, for paging (default 0). |
| shop_id | integer | no | Shop ID in a multistore installation. Defaults to the shop in the connector address. IDs are listed by ps_get_shop_info. |
| items | array of object | when: action=update | update: translations, ID from action=list and the fields to write in language lang. Max 200 items. Fields of each item: id (integer, required): ID of the dictionary item. name (string): Name (feature, attribute group name in the back office, attribute). Max 512 characters. value (string): Feature value. Max 512 characters. public_name (string): Attribute group name shown to customers. Max 512 characters. description (string (HTML)): Description (HTML) of the manufacturer or supplier. Max 65,000 characters. short_description (string (HTML)): Short description of the manufacturer (HTML). Max 65,000 characters. meta_title (string): Meta title. Max 512 characters. meta_description (string): Meta description. Max 512 characters. |
| confirm | boolean | no | false (default) returns a preview and saves nothing. true executes, only after the user approved the preview, together with change_token. |
| change_token | string | when: confirm=true | Token from the preview. Required with confirm=true. Valid 30 minutes, single use, bound to the previewed arguments and data state. |
Limits
One dictionary type and one target language per call. list: max 500 rows (default 100). update: up to 200 items. Revertible with ps_revert_change.
What you see before anything is saved
Claude first calls the tool without confirming it. The module returns a preview (current and new values) and a single-use token valid for 30 minutes. Claude shows you the preview and saves the change only after your yes.
Related tools
- Update product content ps_update_product_content
- Update category content ps_update_category_content
- List features ps_list_features
- Revert change ps_revert_change
Use cases with this tool
- Translate product content into another shop language
- Translate category texts and information pages
- Translate the whole shop, down to filters and brands
Last updated: 2026-10-05