VCS-Einbindugen: Online-Konfiguration

To get Version Control System integration working you have to specify which source files should be translated and how Crowdin should structure the translated files in your repository.


Configure the selected branch to specify the source and translated files path. To open the Branch Configuration dialog click Edit Configuration.

Then, you’ll be able to create a configuration or load a configuration file from your repository.

Integration set up

Loading a Configuration

If you already have a configuration file saved in your repository, you can select this file by following these steps:

  1. Click More.
  2. Select Load configuration from the drop-down list.
  3. Enter the name of the configuration file from your repository.
  4. Click Continue.

Konfiguration laden

Then you can use this configuration as is or you can make some changes, that will be saved to this configuration file.

Creating a Configuration

In the Branch Configuration dialog, you can create a configuration that will be used for the integration.

For that, name the configuration file and click Continue.

Branch configuration

Then, select the source files path, and translated files path using patterns and placeholders listed and explained below.

Once you set up and save the configuration for the selected branch, the configuration file will be saved to the root of the translation branch in your repository.


* (asterisk)

Represents any character in file or directory name. If you specify a “*.json” it will include all files like “messages.json”, “about_us.json” and anything that ends with “.json”.

** (doubled asterisk)

Matches any string recursively (including sub-directories). Note that you can use ** in both source and translation patterns. When using ** in the translation pattern, it will always contain sub-path from source for a certain file. For example, you can use source: ‘/en/**/*.po’ to upload all *.po files to Crowdin recursively. The translation pattern will be ‘/%two_letters_code%/**/%original_file_name%’.

? (question mark)

Matches any single character.


Matches any single character in a set. Behaves exactly like character sets in Regexp, including set negation ([^a-z]).

\ (backslash)

Escapes the next metacharacter.


Use placeholders to identify where translated files will be placed and how they will be named:

Name Beschreibung
%language% Name der Sprache (z.B. Deutsch)
%two_letters_code% Sprachcode ISO 639-1 (z.B. de)
%three_letters_code% Sprachcode ISO 639-2/T (z.B. deu)
%locale% Standort (z.B. de-DE)
%locale_with_underscore% Standort (z.B. de_DE)
%original_file_name% Ursprünglicher Dateiname
%android_code% Android-Standort-ID für die Benennung von „values-“-Ordnern
%osx_code% OS-X-Standort-ID für die Benennung von „lproj“-Ordnern
%original_path% Take parent folders names in Crowdin project to build file path in the resulted bundle
%file_extension% Ursprüngliche Dateierweiterung
%file_name% Dateiname ohne Erweiterung

Advanced Settings

Ignoring Files

In case there are files that should not be translated, use the Ignored Pattern option and Crowdin won’t upload specific files for translation.

Ignorieren von Dateien oder Ordnern


To use custom language codes other than those defined by Crowdin you can set up language mapping. This will help to keep the structure of the exported translation files consistent. You can map as many languages as you need.

Um die Sprachzuordung zu aktivieren, befolgen Sie diese Schritte:

  1. Open the Language Mapping section. Sprachzuordnung
  2. Wählen Sie die gewünschte Sprache und Variable.
  3. Fügen Sie einen benutzerdefinierten Code hinzu.
  4. Click Add mapping to add another custom code.
  5. Klicken Sie auf Speichern. Sprachzuordnung

Configuring Spreadsheets

Define the structure of your file in the Scheme field. List the values in the necessary sequence using commas:

  • identifier — the column contains a unique identifier of the source string
  • source_phrase — this column contains the actual text that should be translated
  • source_or_translation – Crowdin should consider the texts in this column as the source strings for translation and replace them with the translated texts when downloading the resulting file
  • translation — the resulting translation files are placed in this column
  • context — any contextual information that helps to better understand the meaning of the source strings
  • max_length — defines the max. length of the translated texts

If a spreadsheet contains the translations for all target languages, you can use the option Multilingual spreadsheet. Also, indicate the sequence of columns with translations in the Scheme filed, for example: identifier,source_phrase,context,uk,ru,fr (Language Codes).

In case, you do not want the text that is included in the first row to be translated, check Import first line as a header option.

Spreadsheet files

Configuring XML Files

XML Files

Translate Content Defines whether to translate texts placed inside the tags
Translate Attributes Defines whether to translate tags attributes
Content Segmentation Defines whether to split long texts into smaller text segments.
Important! This option disables the possibility to upload existing translations for XML files when enabled.
Translatable Elements This is an array of strings, where each item is the XPaths to DOM element that should be imported.
Sample path: /path/to/node or /path/to/attribute[@attr]

Additional Parameters

The following parameters can’t be configured online:

  • preserve_hierarchy - saves directory structure in Crowdin
  • dest - allows you to specify a file name in Crowdin
  • type - allows you to specify a file type in Crowdin
  • update_option - keeps translations and keeps/removes approvals from the changed strings during the file update
  • commit_message - additional commit message, that can include Git tags
  • export_languages - export translations for the specified languages

After you save the online configuration, a crowdin.yaml file will be created in the configured branch. You can edit this file manually to add the necessary parameters. Read more about the configuration file.

Saving Configuration

Click Save to preview the created configuration.

Save configuration

Click Add File Filter in case you have various file groups with different configurations.

If there are several branches in the project that share the same configuration, and disparate filters should be applied to them, select Apply filters to all translatable branches.

Click Save to save the created configuration.

Apply filters to all the translatable branches

After saving, the upload of localizable files to Crowdin will start.

Sync in progress

Siehe auch

War dieser Artikel hilfreich?