Knowledge Base

Documentation to help you use the POEditor localization platform effectively

How to translate a language file from a Bitbucket project


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:

Get terms - Imports your terms from the Bitbucket file to the selected POEditor language page
Import translations from Bitbucket - Imports translations from your Bitbucket repository to the POEditor language page. If your language page lacks uploaded terms, you'll need to get the terms from Bitbucket first and them import the translations.
Export to Bitbucket - Exports your terms and translations in 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 - Add a rule by which to export strings.
Remove Link - Deletes the link between the POEditor language file and your Bitbucket repo

Bitbucket integration options - POEditor app localization tool

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