Skip to main content

How to Manage Translations and Localization

Ditto's localization workflow is built around variants and Magic Translate — so you can generate, manage, and preview translations entirely within Ditto, without exporting to a separate tool or maintaining parallel spreadsheets.


Step 1: Create a language variant

Each language lives as a variant on your text items. The original text is labeled Base while each language is a separate variant. All your variants are managed from the workspace's Variant Library.

Create a language variant:

  1. Click + New variant in the top right of the Variant Library

  2. Enter the variant name and choose the appropriate locale (eg. German), then click Create Variant


Step 2: Translate with Magic Translate

Magic Translate uses AI to generate translations for your text items directly in Ditto based on the variant’s locale code — no exporting or copy-pasting required. Additionally, if you have localization specific content guidelines, you can attach a variant to a style guide so Ditto’s AI Magic Translate can ingest those rules as it generates the localized content.

Attach a variant to a style guide:

  1. In the relevant style guide, open the menu and click Variant configuration

  2. Select the variant you want to attach to this style guide and click Save

Generate localized copy with Magic translate:

  1. Select a text item, go to its variant tab, and click Add variant

  2. Choose the variant and make sure it has a locale assigned to it, then click Save

  3. The Translate button will appear under your text — click it to generate the localized copy

Auto-translate all project text

Configure your project to automatically attach variants to all project text items and auto-translate localized variants. Once you save this setting, all existing and new text in your project will be translated automatically.

Auto-translate project text:

  1. Open the ... menu and select variant configuration

  2. Add the variant(s) you want all your project text to have by default. This includes both locale-variants and non-locale variants

  3. [Optional] Select the locale-variants you want Ditto to auto-translate, then click Save


Step 3: Preview translations in Figma

Apply a variant to frames directly in Figma to see how translated text fits your mockups — no new design files needed.

Apply a variant:

  1. Select the frame(s) in Figma

  2. Click the Apply variant icon to see a list of your available variants

  3. Select the variant you would like to apply

Did this answer your question?