Skip to content
English - United States
Contact us
  • There are no suggestions because the search field is empty.

Import & Export for Dictionary

A brief guide explaining how to import and export key/value pairs in a Dictionary on TagoIO, including supported file formats, typical use cases, import behavior, and where to get sample files.

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

Overview

All data in a Dictionary can be exported into a CSV or JSON file. Exported files are useful 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
  • Keeping a backup to revert any changes to a known state
Dictionary Pairs menu showing Import/Export options and sample downloads

:::info

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

:::

Exporting a Dictionary

  • Use the Export button at the top of the Dictionary page to download all key/value pairs as a CSV or JSON file.
- Choose CSV or JSON based on how you plan to edit or process the data.

Importing a Dictionary

  • A CSV or JSON file can be imported into a specific language in the Dictionary after being edited (e.g., translated).
- Importing will overwrite the values for all existing keys in the selected language.
  • Any new keys and values present in the imported file will be added to the selected language.

Behavior when adding new keys

  • When you add new keys to a language via import, the Dictionary will also add those keys with empty values to all other languages in the Dictionary.

Samples

TagoIO provides sample CSV and JSON files accessible from the Import and Export buttons for convenience and reference. In the Dictionary UI the menu includes options such as:
  • Import CSV
- Import JSON
  • Get CSV sample
- Get JSON sample

CSV and JSON file requirements

CSV
  • 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 in other columns are 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"). Quotation marks are required if the value contains a comma (e.g. "SOME_KEY","Value for the key, extra content").

JSON

  • 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.