TSV is the plain text file format that can be used to upload translations from your project. The TSV file, similarity to CSV, 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 tab (\t), other separators are not supported.
Description column
TSV file format offers additional description column for providing a description for translation keys.
This column is optional, and descriptions uploaded via CLI are set as "Code Descriptions" by default.
If you want to update translator descriptions, you have to add --uploadOptions UPDATE_DESCRIPTIONS to your CLI command.
Namespace column
TSV file format offers additional namespace column for providing translation key namespaces.
File format example
key english polish
welcome Welcome! Witajcie
about-us About O nas
hello_world Hello World Hejka
Columns are separated with tabs (\t), see also CSV file format.
File format example with DESCRIPTION, and NAMESPACE
key english polish description namespace
welcome Welcome! Witajcie home
about-us About O nas Description text
register Register Rejestracja Button text common
Columns are separated with tabs (\t), see also CSV file format.
Upload with CLI
simplelocalize upload --apiKey <PROJECT_KEY> \
--uploadFormat tsv \
--uploadPath ./translations.tsv
Learn more about SimpleLocalize CLI and translations upload feature.
Download with CLI
simplelocalize download --apiKey <PROJECT_KEY> \
--downloadFormat tsv \
--downloadPath ./translations.tsv
Learn more about SimpleLocalize CLI and translations download feature.
Import with API
curl
--request POST \
--url 'https://api.simplelocalize.io/api/v2/import?uploadFormat=tsv' \
--header 'x-simplelocalize-token: <API_KEY>' \
--form file=@/path/to/your/file.tsv
Learn more about importing translations with API
Export with API
curl
--request GET \
--url https://api.simplelocalize.io/api/v3/export?downloadFormat=tsv \
--header 'x-simplelocalize-token: <API_KEY>'
Learn more about exporting translations with API