Documentation section

Importing localization files

Learn how to import your localization files to Localazy through a web interface.

Importing your localization files to Localazy is an easy alternative to uploading files using our CLI. You can import new keys for your source language or map existing translations to the current source keys.

The web import service supports all the available formats and integrations, and most import features available when using the CLI method.

Importing through file management 🔗

In an application where you have the Owner role, you have access to the file management section.

File management section

There is a + button in the upper right corner, which opens the Import & create new files modal.

Import modal

Upload one or more localization files to begin the import process. In the next step, you will be able to add more or delete staged files for the import. The import wizard will try to guess which languages the localization files represent, but you can also set these manually. Additionally, a unique name for the new Localazy file will be generated, which you can modify, along with the file path. The file name and path combination must be unique, and the file name cannot be empty. Lastly, a common file format or integration type is determined upfront for you, but you may modify it.

Import modal

The last step consists of two options categories. The Format import/export options are format-specific options that modify how the imported files and their phrases are treated during import and export.

The Other import options are common options for all the format types and integrations.

Common options 🔗

Import modal

Mark phrases excluded from this batch as deprecated 🔗

When checked, any existing source key that is not included in the imported files will be marked as deprecated. Deprecated phrases are still available but are not visible to translators.

Import all translations as new 🔗

When checked, every imported translation has to go through a review process. When unchecked, imported translations are marked as current without the necessity to review them. This option does not affect files with the source language.

Skip translations that copy source language 🔗

When checked, phrases that are the same as in the source language are not imported. This is important for platforms like iOS, where localizable files contain the source phrase where the translation is not available. This option has no effect while importing files in the source language.

Localazy file 🔗

When you import multiple files, you may be surprised to see only a single file in the file management table. Localazy files are different from the localization assets you’ve uploaded.

Without going into too much detail, in Localazy, the file doesn’t represent a single separate language file you might find in your project. The Localazy file contains all translations. Therefore, you will see a single file in the list even if it exists in many localized versions. Each file in Localazy is uniquely identified by the file’s type, filename, and path.

The provided filename is the actual name you will see when you download the file, either manually through our CDN or using the CLI method. Additionally, if you provide the path, you can use it in your CLI configuration.

Importing updated localization files into existing Localazy files 🔗

If you wish to add new source keys or translations or update existing ones, you may use the Import content to file option under the Localazy file’s dropdown options.

This import wizard is a simplified version of the import wizard for a new file. The difference is that the file name, path, and type are set and unmodifiable.

Import content to file

Adding a new phrase to a file 🔗

You can add a new phrase into your files when you open the localization file in Localazy.

Find a + button and add a new phrase with a unique key and source text directly in the web interface.

These steps don’t apply to complex files which consist of a more complicated structure, including product flavors and build types, typically found in Android apps.

Add new phrase