Term Localization

Note: Taxonomy Localization is a plan-based feature. Contact our support team to enable it for your organization. This feature is currently available for CMA use only. Publishing localized taxonomy names and terms to CDA is coming soon. You can begin preparing your localized structures now, but localized values will not appear in published content until publishing support is released.

Term Localization allows you to localize individual taxonomy terms for each locale without duplicating or restructuring the taxonomy. Each localized term shares the same UID as its master term, ensuring consistent tagging, filtering, and search behavior across locales.

Note: You can localize the taxonomy name to provide language-specific labels for the taxonomy itself. To localize the terms within that taxonomy, edit individual terms from the same Taxonomy Details page.

Key Benefits

Localizing taxonomy terms offers the following advantages:

• Multilingual tagging: Apply consistent term names across multiple locales.
• Centralized management: View and manage all term translations in a unified table per taxonomy.
• Fallback resolution: Display translated or fallback values automatically, based on locale.
• Data integrity: Localized terms inherit the master term's UID.
• Reduced overhead: Localized terms are not counted as separate entities.
• Branch awareness: Fallback behavior respects the branch-specific hierarchy.

Localize a Term

Localizing a term allows you to define locale-specific values that can be used in entries without altering the taxonomy structure.

To localize a term, log in to your Contentstack account, and perform the following steps:

1. Navigate to your stack, go to Settings, and select Taxonomy.
2. Select the taxonomy with the terms you need to localize.
3. On the Taxonomy Details page, select the desired term and review the locale table.

   Note: The list of locales is automatically derived from all locales available across the branches in the stack. This ensures that any locale configured in any branch is reflected in the taxonomy localization view.

4. Click the vertical ellipsis next to the locale you want to localize and select Edit.
5. In the Edit Term modal, enter the localized name for the selected locale.
6. Click Save.

Unlocalize a Term

Unlocalizing a term removes its locale-specific value and reverts the locale to fallback behavior.

To unlocalize a term, log in to your Contentstack account, and perform the following steps:

1. Navigate to your stack, go to Settings, and select Taxonomy.
2. Select the taxonomy that contains the term you want to unlocalize.
3. On the Taxonomy Details page, select the term.
4. Click the vertical ellipsis next to the locale and choose Unlocalize.
5. In the modal, confirm the action by clicking Unlocalize.

Term Localization empowers teams to support multilingual content without duplicating taxonomy structures. Whether serving global markets or managing multiple branches, this feature ensures flexibility and centralized control without sacrificing consistency.

API Reference

To localize or unlocalize terms via API, refer to the Localize a Term and Unlocalize a Term API requests.