Import / Export for Mobile - for Developers

Use files in your Mobile App development workflows

From the Localize dashboard, you can import and export phrases and website translations in various file formats.

You can also import/export Glossary terms.

To import or export simply go to the File Import / Export page in your dashboard.

Below you will find basic instructions for importing/exporting any of the supported file types for Mobile projects.

Supported File Formats

For details on the requirements for the various file formats supported in mobile projects, select a file format below to view our developer docs for that format.

🚧

UTF-8 Character Encoding

Be sure that you are using the UTF-8 character encoding when working with the external files you are creating for importing purposes, so that special characters like accents are encoded properly.

Importing Files

Importing your source language phrases into the Localize platform and translation workflow allows you to invite your translators to add/edit translations or to order professional translations from one of our third-party providers directly through our platform. You can also import phrases and translations that were done outside of Localize.

Before importing, ensure your file adheres to the file requirements for the file type you are importing. You can find these requirements on the page for that file format.

Navigate to the File Import / Export: Import tab in your dashboard.

📘

Phrase Keys Required

All mobile file formats require a phrase key for each phrase. This is a unique identifier for the phrase, used in your mobile app to identify the phrase.

📘

Sample Files

You can download a sample file of the format of choice by clicking on its icon and then clicking the Download Sample button. Use this as a guide for creating your import files.

  1. Drag-and-drop a file to import into the box, or select a file to import (or use Google Drive).

    1. If you have multiple files to import, repeat.
    2. You can also import a ZIP file that contains multiple import files.
  2. The file type will be auto-detected and displayed.

    1. If it's incorrect, select the appropriate format from the drop-down.
    2. Repeat this for each file you are importing.
  3. The language will be auto-detected and displayed.

    1. If it's incorrect, select the appropriate language.

    2. Repeat this for each file you are importing.

  4. Add any Labels to the phrase by selecting one or more from the list.

  5. Specify the import type: Phrases or Glossary terms

  6. Select the Replace labels on duplicate imported phrases checkbox if you want new labels to replace the old ones on an existing phrase.

    1. When not checked, the new labels are added to any existing ones.
  7. Select the Mark all phrases as human checkbox if all phrases have been reviewed by a human.

  8. Click the Submit button.

  9. Wait for the file(s) to be uploaded.

  10. Success! View the file details to see how many phrases were created, updated, etc.

All phrases in the import file will be categorized as follows:

  • Created
    • A new phrase was created.
  • Updated
    • An existing phrase was updated.
  • Unchanged
    • The source phrase and translation matched the existing content so no action was taken.
  • Ignored
    • No phrase was found for the given phraseKey when importing a target language file.
    • The phrase is new but it does not have a value to match the phraseKey.

🚧

Results of Importing Translations

When you import translations, your Localize dashboard gets updated:

  • existing translations will be overwritten
  • new translations will be added from the file that you upload
  • by default, phrases will have the Import tag applied
    • If you opt to select the Mark all phrases as human reviewed. checkbox, then the phrases will be marked with your name, indicating that those phrases were marked as human.

Destination After Import

  • If you are using the Translation QA Workflow, then your imported phrases will be automatically moved to one of the Translation QA bins, either Needs Review or Needs Translation.
  • If you are NOT using the Translation QA Workflow, then your imported phrases will be automatically moved to the Published bin, whether they have translations or not.

Phrase Keys Displayed with Phrases

After importing a source language file, Localize will show the phrase Key along with the phrase in the Localize dashboard.

Import with Pluralized Phrases

Note, if a phrase is pluralized, then it will have multiple translations for a single source phrase. Unless otherwise noted in a specific file format, all translations will be imported together, separated by 4 vertical bars ||||.

Source phrase:
Your trial ends in <var count=""></var> days

Translation:
Su prueba termina en <var count=""></var> día||||Su prueba termina en <var count=""></var> días

Import History

After your import has been completed, you can view the status under Import History.

  • If your import is successful, you can click View to see:
    • How many phrases were created/updated/unchanged/ignored
    • Language
    • File format
  • If your import fails, click Review Error to see details about the error.

Exporting Files

You can export your translations for backup purposes, send them to your translators (who can translate your content using a third-party tool), or delegate the translation process to a translation service of your choice.

Navigate to the File Import / Export: Export tab in your dashboard.

  1. Specify the export type: Phrases or Glossary terms
  2. Select the desired file type under File Format.
  3. Select a filter that will determine which phrases get exported:
    1. If using the Translation QA Workflow:
      a. Published translations
      b. Machine translations
      c. Human translations
      d. No translations
      e. Needs human translations
      f. Translations that need review
      g. Phrases that need translations
      h. Phrases with rejected translations
    2. If not using the Translation QA Workflow:
      a. Published translations
      b. Machine translations
      c. Human translations
      d. No translations
      e. Needs human translations
  4. Select the language(s) you are exporting.
    1. If you select multiple languages, a separate file will be downloaded for each selected language.
    2. See the note below: Exporting Multiple Files Simultaneously
  5. Select the destination drive to which you would like to export your file(s).
    1. Desktop
    2. Google Drive
  6. Click the Export button.
  7. Wait for your download to complete, then close the popup dialog.
  8. If you selected Google Drive as your destination above:
    1. If this is your first time using Google Drive in your Localize dashboard you'll be asked to connect with your Google Drive account.
    2. Otherwise, you'll be asked if you want to save the file(s) in your main drive or in a specific folder.

🚧

Exporting Multiple Files Simultaneously

If you choose to export multiple files in a single export, a separate file will be downloaded for each chosen language. For security purposes, some browsers will not allow this and will only download 1 file. To enable multi-file downloads, follow these instructions:

Google Chrome:

  1. Bring up Settings in the browser.
  2. Select Privacy and security.
  3. In the Content section select Pop-ups and redirects.
  4. In the Allowed to send pop-ups and use redirects section click Add.
  5. Enter app.localizejs.com and click Add.

Microsoft Edge:

  1. Bring up Settings in the browser.
  2. Select Cookies and site permissions.
  3. Select Pop-ups and redirects.
  4. In the Allow section click the Add button.
  5. Enter app.localizejs.com and click Add.

Export with Pluralized Phrases

Note, if a phrase is pluralized, then it will have multiple translations for a single source phrase. Unless otherwise noted in a specific file format, all translations will be exported together, separated by 4 vertical bars ||||.

Translators working in the exported file will need to be made aware of, and maintain these separating bars.

Source phrase:
Your trial ends in <var count=""></var> days

Translation:
Su prueba termina en <var count=""></var> día||||Su prueba termina en <var count=""></var> días

Exporting Selected Phrases

Alternatively, you can filter exactly which phrases you want to export on the Manage Phrases page. Find out how....