Import & Export for Dictionary

Import & Export for Dictionary

The Dictionary also provides a quick and easy way to import and export a Dictionary’s key and value pairs via the two buttons at the top of a Dictionary page.

All data in a Dictionary can be exported into a CSV or JSON file, and that file can be used for: editing in another program (such as Excel or another editor), sending for translation to another language by keeping the keys and editing only the values, or just for keeping a backup to have the ability to revert any changes to a known state in the saved file.

A CSV or JSON file can be imported into a language in the Dictionary after being edited (translated). This action will overwrite the values for all existing keys, and it will add any new keys and values to the selected language. 

When adding new keys to a language, the behavior of the Dictionary is the same, as it will add the keys with empty values to all the other languages in the Dictionary.

TagoIO provides samples for CSV and JSON files in the Import and Export buttons for your convenience and for reference.

For both CSV and JSON files, the samples of the Dictionary show the exact structure for the files. Here are some requirements:


  • Can optionally contain a header if the first row has Key on the first column and Value on the second column

  • Only the first two columns will be used, values contained in other columns will be ignored

  • The key should follow the same format as on the TagoIO Admin: all caps, no spaces (use underscores), only alphanumeric characters

  • When using a text editor to edit the file, it’s preferable to enclose each field in quotation marks (e.g. ”SOME_KEY”,”Value for the key” or at least keep in mind that the use of quotation marks will be required if the value contains a comma (e.g. ”SOME_KEY”,”Value for the key, extra content”)


  • It should be an array of objects containing a key and a value only, anything else is ignored

  • The key should follow the same format as on the TagoIO Admin: all caps, no spaces (use underscores), only alphanumeric characters

The import and export functionality is available for users in the Scale plan

Watch this webinar to see a complete walk-through for creating multilingual RUN applications and using the import/export feature for translations. The section on import/export begins at minute 13:25.

    • Related Articles

    • Using Dictionaries & Multi-language

      Use the Dictionary to deploy applications to end-users (RUN users) in any language. All you have to do is to create a dictionary, use the #SLUG.KEY# format in the texts that will be substituted, and then select the languages that should be available ...
    • Dictionaries

      The innovative dictionary feature from TagoIO provides more possibilities to improve your application by allowing you to edit any messages in your dashboards and to provide your solution in any language. Translate text messages to any language ...
    • Single Sign-On (SSO)

      By using our Single Sign-On, SSO, integration, end-users are allowed to sign in into your RUN application using the credentials from your own trusted user database. This database is provided by third-party services such as Okta, Microsoft Azure AD, ...
    • Okta SSO

      When using Okta as the identity provider, follow these steps to configure your SSO:  Access the Admin panel on your Okta account, then browse to the Applications section. Click on Add Application and then Create New App. In the modal, select Web for ...
    • User Management

      You can visualize and control all users that sign up in your application under the User Management module. When you create and deploy your solution using TagoRun, all users that sign up will be listed in this area. You can grant or remove access, ...