When preparing translations for uploading in Excel format, you have two options:

  • One file — one language.
  • One file — multiple languages (multilingual excel).

This document covers both options. Note that currently we support Spreadsheets (.xls) and Excel Workbooks (.xlsx). The latter is the default format in Excel 2007 and later versions.

One language per Excel file

If you choose this approach, then you'll need to separate translations for different languages into multiple files. The principle is one worksheet and one language per file. It is also advised to name the files after the locale codes (en, de, fr etc) so that Lokalise can detect the language properly.

File format

Your Excel file should contain the following columns:

  • Key name (required)
  • Translation (optional)
  • Description (optional)
  • Comment (optional)

Here is an example of a valid Excel file:

The order of the columns may be different if you are uploading via the web interface because it would be possible to designate arbitrary columns as key name, translation, and so on. However, if you are importing via the API/CLI tool, the columns must follow the order shown above.

Uploading file

Proceed to the Upload page and choose one or more files from your PC. You will be presented with the following dialog:

Using these dropdowns you may specify what data each column contains or ignore the given column:

Once you are ready, press Apply and then click Import the files to start the uploading process.

Check the Activity page to view the status of your upload:

Downloading file

To download translations in Excel format, proceed to the Download page and choose Excel from the Format dropdown. Translations for different language will be placed into separate files:

Please remember that in order to export descriptions and comments, you need to enable the corresponding options:

Multilingual Excel

Multilingual Excel format allows you to upload a single file containing translations for multiple languages.

File format

Your multilingual Excel file should follow these requirements:

  1. The first row must be a header containing the following fields: key (required), locale_code1, locale_code2, locale_codeN (at least one locale code has to be provided), description (optional), comments (optional)
  2. Subsequent rows contain the actual key data. One row — one key.

So, here is an example of a valid multilingual Excel file:

  • It contains two keys: country and password.
  • There are translations for three languages: English, German, and French.
  • Each key has a description and a comment (remember that these fields are optional).

Uploading file

After preparing a multilingual Excel file, you may proceed to the Upload page and start the importing process as usual. After the file is selected, you will be presented with the following dialog:

Using these dropdowns you may specify what data a specific column contains or ignore the given column altogether. It is also possible to adjust languages by clicking on the locales dropdowns:

After you are done, click Apply. You should see a single file with all the locales it contains:

After the upload is finished, you may check detailed information by accessing the Activity page:

Downloading file

To download translations in multilingual Excel format, proceed to the Download page and choose Multilingual Excel from the Format dropdown. All translation keys assigned to the same Excel file will be exported in a single file with the proper name. All other keys that are not assigned to any file, will be placed inside the no_filename.xlsx file.

Please note that in order to export descriptions and comments, you need to enable the corresponding options:

Did this answer your question?