Alex Terehov avatar
Written by Alex Terehov
Updated over a week ago

Ditto is a tool for teams to manage their product text from design to production with a single source of truth.

Supported content

Ditto integration supports Components only. Components in Ditto are text items that get synced across projects and allow teams to standardize and reuse text.

Projects are not supported.


Creating connection on Ditto

First, you'll need to create a connection on Ditto. To achieve that, open Connections tab in Account Settings, find Lokalise, and click Open:

In the popup click Add connection and then copy the API key:

Adding app on Lokalise

Open your project on Lokalise (please make sure to use the Software localization project type), click Apps in the top menu, and find Ditto in the list. Click on it:

Then click Install. Paste the API key obtained from Ditto on the previous step and click Authorize to finish installation:

Importing content from Ditto to Lokalise

Once you've installed the app on Lokalise, the list of available components from Ditto will be presented to you. The content synchronization should start immediately. To start it manually, click Refresh.

On the Ready for import view, choose one or more items and click Import from Ditto:

You'll be presented with the following dialog:

Choose the languages to include in the import operation.

Tick the Overwrite existing keys option if you want to update existing translation keys with any updates that happened on the Ditto content since the last import. Updated keys will return to the Unverified status.

If you want to use Automations, you should import only the default language with the Overwrite existing keys option enabled. An alternative is to import all the desired languages, but keeping the Overwrite existing keys option disabled.

Importing will happen in the background, and once the operation is completed, you'll see the following notification. Click View content to navigate to the Imported view:

Reimporting updated content from Ditto to Lokalise

To import updated content from Ditto components, you can use the Refresh button to see the last update date, select the items to reimport, and click on Reimport from Ditto:

Performing translations

Proceed to the project editor on Lokalise and perform translations as usual. Here is a sample where the appropriate tags have been linked to the inserted keys:

The following tags have been added automatically:

  • ditto β€” refers to the app itself.

  • Test group β€” the item's title that was imported from Ditto.

The key names are generated using group and component names separated with a dot (.) delimiter.

Exporting content from Lokalise to Ditto

Once the translations have been reviewed, you can return to the Ditto app on Lokalise, and switch to the Imported view.

Choose one or more items and click Export to Ditto:

You'll be presented with the following dialog:

Choose one or more languages and hit Export to Ditto.

The operation will be performed in the background, and you'll be notified once it is completed.

Did this answer your question?