CSV - translations

Last modified: January 05, 2022Author: Jakub Pomykała

CSV Translations is the plain text file format which can be used to upload translations from your project. The csv file must start from a header, where the first column is always a key column, next are language keys columns. Every value should be separated with a comma (,), other separators are not supported. Optionally, your values can be wrapped with single (') or double quotes (").

File format example

"key","english","polish"
"welcome","Welcome!","Witajcie"
"about-us","About","O nas"
"register","Register","Rejestracja"

Upload with CLI

simplelocalize upload --apiKey <PROJECT_KEY> \
  --uploadFormat csv-translations \
  --uploadPath ./translations.csv

Learn more about SimpleLocalize CLI and translations upload feature.

Download with CLI

simplelocalize download --apiKey <PROJECT_KEY> \
  --downloadFormat csv-translations \
  --downloadPath ./translations.csv

Learn more about SimpleLocalize CLI and translations download feature.

Import with API

curl
    --request POST \
    --url 'https://api.simplelocalize.io/api/v2/import?uploadFormat=csv-translations' \
    --header 'x-simplelocalize-token: <API_KEY>' \
    --form file=@/path/to/your/file.csv

Learn more about importing translations with API

Export with API

curl
    --request GET \
    --url https://api.simplelocalize.io/api/v3/export?downloadFormat=csv-translations \
    --header 'x-simplelocalize-token: <API_KEY>'

Learn more about exporting translations with API