[{"data":1,"prerenderedAt":71},["ShallowReactive",2],{"help-article-locale-groups":3},{"data":4},{"title":5,"excerpt":6,"content":7,"help_category":8,"seo":11},"Locale Groups & Translation","Learn how m18t links translated content with a locale group, how to create sibling translations, and how the group drives a correct push to localized Strapi.","\u003Cp>\u003Cstrong>What you'll learn\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cul>\n\u003Cli>How m18t links translated versions of a piece together with a locale group.\u003C\u002Fli>\n\u003Cli>How to create a sibling translation and keep them paired.\u003C\u002Fli>\n\u003Cli>How the locale group drives a correct push to a localized Strapi CMS.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Chr>\n\u003Ch2>The concept: translation siblings\u003C\u002Fh2>\n\u003Cp>When you publish an article in English and then in Arabic, you don't want them treated as two unrelated posts. You want your site to know "these are the same article in two languages" so a reader clicking the language toggle lands on the right translation instead of a 404.\u003C\u002Fp>\n\u003Cp>m18t handles this with a \u003Cstrong>locale group\u003C\u002Fstrong> — a shared ID that ties two or more \u003Ca href=\"\u002Fhelp\u002Fthe-unified-content-table\">content\u003C\u002Fa> rows together as siblings. Each row keeps its own locale, body, slug, and \u003Ca href=\"\u002Fhelp\u002Fthe-seo-philosophy\">SEO\u003C\u002Fa>, but they share one group ID. When m18t \u003Ca href=\"\u002Fhelp\u002Fpushing-to-your-cms\">pushes to a CMS\u003C\u002Fa> that supports localization (Strapi v5 today), it uses that group to link the translations through the CMS's own localization API rather than uploading disconnected copies.\u003C\u002Fp>\n\u003Cp>There's no "master" language. Siblings are equal — the group is just the thread that connects them.\u003C\u002Fp>\n\u003Ch2>How to translate a piece of content\u003C\u002Fh2>\n\u003Col>\n\u003Cli>Open the \u003Ca href=\"\u002Fhelp\u002Fthe-unified-content-table\">content\u003C\u002Fa> piece you want to translate (e.g. the English version).\u003C\u002Fli>\n\u003Cli>Go to the \u003Cstrong>Localization\u003C\u002Fstrong> tab.\u003C\u002Fli>\n\u003Cli>You'll see the \u003Cstrong>Locale Group ID\u003C\u002Fstrong> field. Two rows with the same Locale Group ID are linked as siblings. Use \u003Cstrong>Generate New ID\u003C\u002Fstrong> if the piece doesn't have a group yet.\u003C\u002Fli>\n\u003Cli>Under the linked variants, use the create-translation action for the locale you're missing — e.g. \u003Cstrong>Create English Version\u003C\u002Fstrong> or \u003Cstrong>Create Arabic Version\u003C\u002Fstrong>. m18t creates a new row in the target locale, carries over the same locale group, and opens it so you can write the translation.\u003C\u002Fli>\n\u003Cli>Write the translation and save.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Once both siblings exist and share the group, they show up in each other's \u003Cstrong>Linked Variants\u003C\u002Fstrong> list, and you can jump between them from the Localization tab.\u003C\u002Fp>\n\u003Ch2>Pushing localized content to Strapi\u003C\u002Fh2>\n\u003Cp>On the \u003Cstrong>Publishing\u003C\u002Fstrong> tab, the \u003Cstrong>Push to CMS\u003C\u002Fstrong> section shows a \u003Cstrong>Localization Sync Status\u003C\u002Fstrong> panel listing the current piece and each sibling, with whether each one has been pushed yet (and its CMS document ID once it has).\u003C\u002Fp>\n\u003Cp>When you push, you can tick \u003Cstrong>Sync current and all unsynced sibling locales\u003C\u002Fstrong> to send the current piece plus any siblings that haven't been pushed, linking them in the CMS in the same operation. See \u003Ca href=\"\u002Fhelp\u002Fpushing-to-your-cms\">Pushing to Your CMS\u003C\u002Fa> for the full push flow.\u003C\u002Fp>\n\u003Ch2>Common variations\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>Changing a sibling's locale group.\u003C\u002Fstrong> Edit the Locale Group ID on the Localization tab. Matching IDs is what makes two rows siblings; if they don't match, they aren't linked.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>One language only.\u003C\u002Fstrong> A piece doesn't need a sibling. If you only publish in one language, you can leave it ungrouped — locale groups only matter when you have translations to pair.\u003C\u002Fp>\n\u003Ch2>FAQ\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>Why aren't my translations linking in Strapi?\u003C\u002Fstrong>\nThe Strapi collection type must have i18n localization enabled in Strapi's Content-Type Builder. If localization is off on that collection, Strapi rejects the linking payload. Confirm your \u003Ca href=\"\u002Fhelp\u002Fconnect-strapi\">Strapi connection\u003C\u002Fa> and that the target collection is localized.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Do the two languages need the same slug?\u003C\u002Fstrong>\nNo. Each sibling keeps its own slug and SEO. The locale group, not the slug, is what links them.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Which CMS platforms support linked translations?\u003C\u002Fstrong>\nStrapi v5 is the only native CMS today, and its localization is handled correctly. Other CMS vendors are roadmap — see \u003Ca href=\"\u002Fhelp\u002Fpushing-to-your-cms\">Pushing to Your CMS\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>What happens if I push one sibling but not the other?\u003C\u002Fstrong>\nThe Localization Sync Status panel will show one as synced and the other as not. Use the "Sync current and all unsynced sibling locales" checkbox to catch up the rest on your next push.\u003C\u002Fp>\n\u003Ch2>What's next\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Ca href=\"\u002Fhelp\u002Fpushing-to-your-cms\">Pushing to Your CMS\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fhelp\u002Fthe-unified-content-table\">The Unified Content Table\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fhelp\u002Fregistering-a-custom-content-type\">Registering a Custom Content Type\u003C\u002Fa>\u003C\u002Fli>\n\u003C\u002Ful>\n",{"slug":9,"title":10},"content-and-publishing","Content & Publishing",{"meta_title":12,"meta_description":6,"keywords":13,"canonical_url":14,"og_title":5,"og_description":15,"og_image":16,"robots":17,"json_ld":18},"Locale Groups & Translation | m18t Help","locale groups, translation, content localization, sibling translations, strapi i18n, localized publishing","https:\u002F\u002Fm18t.com\u002Fhelp\u002Flocale-groups","A locale group ties translated content rows together as equal siblings and links them through Strapi's localization API on push.","https:\u002F\u002Fm18t.com\u002Fog-default.png","index, follow",{"@context":19,"@graph":20},"https:\u002F\u002Fschema.org",[21,34,55],{"@type":22,"headline":5,"description":6,"articleSection":10,"inLanguage":23,"datePublished":24,"dateModified":24,"image":16,"author":25,"publisher":29,"mainEntityOfPage":32},"Article","en","2026-06-25",{"@type":26,"name":27,"url":28},"Organization","m18t","https:\u002F\u002Fm18t.com",{"@type":26,"name":27,"url":28,"logo":30},{"@type":31,"url":16},"ImageObject",{"@type":33,"@id":14},"WebPage",{"@type":35,"mainEntity":36},"FAQPage",[37,43,47,51],{"@type":38,"name":39,"acceptedAnswer":40},"Question","Why aren't my translations linking in Strapi?",{"@type":41,"text":42},"Answer","The Strapi collection type must have i18n localization enabled in Strapi's Content-Type Builder. If localization is off on that collection, Strapi rejects the linking payload. Confirm your Strapi connection and that the target collection is localized.",{"@type":38,"name":44,"acceptedAnswer":45},"Do the two languages need the same slug?",{"@type":41,"text":46},"No. Each sibling keeps its own slug and SEO. The locale group, not the slug, is what links them.",{"@type":38,"name":48,"acceptedAnswer":49},"Which CMS platforms support linked translations?",{"@type":41,"text":50},"Strapi v5 is the only native CMS today, and its localization is handled correctly. Other CMS vendors are roadmap.",{"@type":38,"name":52,"acceptedAnswer":53},"What happens if I push one sibling but not the other?",{"@type":41,"text":54},"The Localization Sync Status panel will show one as synced and the other as not. Use the \"Sync current and all unsynced sibling locales\" checkbox to catch up the rest on your next push.",{"@type":56,"itemListElement":57},"BreadcrumbList",[58,62,66,69],{"@type":59,"position":60,"name":61,"item":28},"ListItem",1,"Home",{"@type":59,"position":63,"name":64,"item":65},2,"Help","https:\u002F\u002Fm18t.com\u002Fhelp",{"@type":59,"position":67,"name":10,"item":68},3,"https:\u002F\u002Fm18t.com\u002Fhelp\u002Fcategories\u002Fcontent-and-publishing",{"@type":59,"position":70,"name":5,"item":14},4,1786312169816]