Merging translations from Crowdin
Crowdin automatically syncs the
gitlab.pot file with the Crowdin service, presenting
newly added externalized strings to the community of translators.
The GitLab Crowdin Bot also creates merge requests
to take newly approved translation submissions and merge them into the
files. Check the merge requests created by
to see new and merged merge requests.
By default Crowdin commits translations with
[skip ci] in the commit
message. This avoids an excessive number of pipelines from running.
Before merging translations, make sure to trigger a pipeline to validate
translations. Static analysis validates things Crowdin doesn't do. Create
a new pipeline at
(requires the Developer role) for the
If there are validation errors, the easiest solution is to disapprove the offending string in Crowdin, leaving a comment with what is required to fix the errors. There's an issue that suggests automating this process. Disapproving excludes the invalid translation. The merge request is then updated within a few minutes.
If the translation fails validation due to angle brackets (
it should be disapproved in Crowdin. Our strings must use variables
for HTML instead.
It might be useful to pause the integration on the Crowdin side for a moment so translations don't keep coming. You can do this by clicking Pause sync on the Crowdin integration settings page.
After all translations are determined to be appropriate and the pipelines pass,
you can merge the translations into the default branch. When merging translations,
be sure to select the Remove source branch checkbox. This causes Crowdin
to recreate the
master-i18n branch from the default branch after merging the new
We are discussing automating this entire process.
Recreate the merge request
Crowdin creates a new merge request as soon as the old one is closed
or merged. But it does not recreate the
master-i18n branch every
time. To force Crowdin to recreate the branch, close any open merge requests
and delete the
This might be needed when the merge request contains failures that have been fixed on the default branch.
Recreate the GitLab integration in Crowdin
NOTE: These instructions work only for GitLab Team Members.
If for some reason the GitLab integration in Crowdin doesn't exist, you can recreate it with the following steps:
- Sign in to GitLab as
gitlab-crowdin-bot. (If you're a GitLab Team Member, find credentials in the GitLab shared 1Password account.)
- Sign in to Crowdin with the GitLab integration.
- Go to Settings > Integrations > GitLab > Set Up Integration.
- Select the
- In Select Branches for Translation, select
- Ensure the Service Branch Name is
Manually update the translation levels
There's no automated way to pull the translation levels from Crowdin, to display
this information in the language selection dropdown. Therefore, the translation
levels are hard-coded in the
TRANSLATION_LEVELS constant in
and must be regularly updated.
To update the translation levels: