Skip to main content

Product translation

Same product semantics with locale-keyed values: nested objects map language codes (e.g. en, fr) for title, description, handle, files, metafields, option keys, variants, and SEO meta. Used for flows that push or update translated content without duplicating the full product per locale.

Full JSON example​

{
    "sku": "FS-03",
    "title": {
        "en": "Product title FS-03",
        "fr": "Titre du produit FS-03"
    },
    "description": {
        "en": "Product description FS-03",
        "fr": "Description du produit FS-03"
    },
    "handle": {
        "en": "product-handle-fs-03",
        "fr": "produit-handle-fs-03"
    },
    "not-found-handle": {
        "en": "/collections/all",
        "fr": "/collections/all"
    },
    "type": {
        "en": "Product type FS-03",
        "fr": "Type de produit FS-03"
    },
    "files": {
        "manual": {
            "en": "https://www.orimi.com/pdf-test.pdf",
            "fr": "https://www.orimi.com/pdf-test.pdf"
        },
        "namespace.key1": {
            "en": "https://www.orimi.com/pdf-test.pdf",
            "fr": "https://www.orimi.com/pdf-test.pdf"
        }
    },
    "metafields": {
        "addition_features": {
            "en": "Translated metafield",
            "fr": "Métachamp traduit"
        },
        "namespace.key2": {
            "en": "Translated metafield",
            "fr": "Métachamp traduit"
        }
    },
    "optionKeys": {
      "color": {
        "en": "color",
        "fr": "couleur"
      }
    },
    "variants": [
        {
            "sku": "FS-03-1",
            "optionValues": {
                "color": {
                    "en": "Pink",
                    "fr": "Rose"
                }
            },
            "files": {
                "variantManual": {
                    "en": "https://www.orimi.com/pdf-test.pdf",
                    "fr": "https://www.orimi.com/pdf-test.pdf"
                },
                "namespace.variantKey1": {
                    "en": "https://www.orimi.com/pdf-test.pdf",
                    "fr": "https://www.orimi.com/pdf-test.pdf"
                }
            },
            "metafields": {
                "variant_addition_features": {
                    "en": "Translated metafield",
                    "fr": "Métachamp traduit"
                },
                "namespace.variantKey2": {
                    "en": "Translated metafield",
                    "fr": "Métachamp traduit"
                }
            }
        }
    ],
    "metaTitle": {
        "en": "SEO Product Meta Title",
        "fr": "Méta-titre du produit SEO"
    },
    "metaDescription": {
        "en": "A detailed meta description for SEO.",
        "fr": "Une méta description détaillée pour le référencement."
    }
}

Notes​

  • Translatable fields are objects like { "en": "...", "fr": "..." }; add locales the same way.
  • optionKeys and variant optionValues align option labels and values to target languages.