Uploading Existing Translations (File-based)

If you have some existing translations, you can upload them to your project in Crowdin. Import files with translations in your project’s Translations tab or language page, or open a specific file in the Editor and upload translations from there. The best practice is to upload translated files with the key-value structure.

Key-value Formats

You can easily upload translations for source files with a key-value structure.

This includes the following file formats: Android XML, macOS/iOS Strings, Stringsdict, JSON, Chrome JSON, GO JSON, i18next JSON, FBT JSON, XLIFF, XLIFF 2.0, Java Properties, Play Properties, Java Properties XML, RESX, RESW, RES JSON, YAML, INI, Joomla INI, JS, FJS, PO, TS, QT TS, Blackberry, Symbian, Flex, BADA, TOML, Coffee, DKLANG, XAML, SRT, VTT, VTT2, SBV, SVG, DTD, CSV, RC, WXL, Maxthon, Haml, XLSX, PLIST, PHP, ARB, VDF.

The system maps uploaded translations according to the string keys.

Text and HTML-based Formats

For files that do not have a defined structure, translation upload is handled by an experimental machine learning technology.

This includes the following file formats: HTML, Front Matter HTML, Markdown, Front Matter Markdown, TXT, Generic XML, Web XML, DOCX, HAML, IDML, DITA, Wiki, FLSNP, MIF, and ADOC.

To achieve the best results, we recommend uploading translation files with the same or as close as possible file structure as in source files.

Currently, this feature is available for the following languages (not depending on the language pair combination): Arabic, Chinese Simplified, Chinese Traditional, English, French, German, Italian, Japanese, Korean, Dutch, Polish, Portuguese, Portuguese Brazilian, Spanish, Thai, Turkish, and Russian.

Uploading Translations via Translations Tab

To upload multiple files with translations, follow these steps:

  1. Open your project and go to the Translations tab.
  2. Click Upload existing translations to expand the respective section.
  3. Drag and drop files from your machine, or click Select Files. You can upload ZIP archives to add multiple folders and files.
  4. Crowdin automatically matches uploaded translations with appropriate source files and languages. Check it manually to make sure everything is matched correctly.
  5. (Optional) Click under the uploaded file list to view the advanced import settings.
  6. Click Import to apply the translations to the source files.

Uploading Translations via Language Page

  1. Select the language on the project page.
  2. Click next to the file translations should be uploaded to.
  3. Select Upload Translations.

Uploading Translations via Editor

To upload a file with translations, follow these steps:

  1. Open the necessary file in the Editor.
  2. Click on the Main menu in the upper-left corner.
  3. Go to File > Upload Translations.

Uploading XLIFF Translations

You can do the offline translation for all file formats, having downloaded existing content in the XLIFF format. As soon as the offline translations are finished, use Upload XLIFF Translations.

To upload XLIFF translations for all files for a specific target language, follow these steps:

  1. Select the language on the project page.
  2. Click and select Upload XLIFF Translations.

Advanced Import Settings

You can configure the desired system behavior toward the uploaded translations using the available options in the appeared dialog.

Note: By default, translations that match the source strings, translations that are identical to the existing ones, and translations for hidden strings are skipped during the upload.

Was this article helpful?