Knowledge Base

Documentation to help you use the POEditor localization platform effectively

How to translate a language file from a Bitbucket project

Owner

You can connect your POEditor account with a Bitbucket account to more easily manage the localization of language files hosted on this code hosting service. Note that the localization project needs to be hosted on your POEditor account in order for you to be able to link the files on Bitbucket to the localization project languages. However, after these links are made, you can also allow the localization project admins to import/export strings using the integration.

Connect your repos with POEditor

Go to Integrations > Bitbucket and then click the Connect button. Log in to your Bitbucket account (if you aren't) and authorize the POEditor localization app.

Link your language files

In the Bitbucket integration page, select a POEditor project and the language you want to link, then press Link to a Bitbucket file. Then choose a repository, branch and file and link them together.

Link POEditor project language to Bitbucket file

Manage translations and syncing the language files

Linked language files have non-automated features on the Bitbucket integration page:

Import terms - Uploads your terms from the file to the selected POEditor language.
Import terms and translations - Uploads your terms and the corresponding translations from the file to the selected POEditor language.
Import translations - Adds translations from your file to the language in your POEditor project. Note that you can import translations only after having imported terms.
Export to GitHub - Exports your terms and translations from the linked language to the file selected by you in the linking stage.
Add import rule - Adds a rule by which to tag strings on import.
Add export rule - Adds a rule by which to export strings.
Remove link - Deletes the link between the POEditor language and the Bitbucket repo.

Bitbucket integration options - POEditor app localization tool

You can use the Import from and Export to options at the bottom of the page to perform bulk actions for multiple languages at a time.

You can automatically sync the terms whenever you make changes in your repos with Bitbucket webhooks. Here's some info about using webhooks with POEditor.

How to give access to the Bitbucket integration to localization project admins

After you, as the project owner, set up the links between the files on Bitbucket and the languages in the l10n project, you can give admins access to the integration from the projects's settings, by enabling the option Admins Can Access Integrations.

Project Settings - POEditor localization management platform

Additional help