Once you install the Bitbucket integration, Transifex and Bitbucket sync automatically in both directions. This article explains what triggers each sync, how to connect resources that already exist in Transifex, and how to check that the integration is healthy.
🔒 Available on: All plans · Who can do this: Organization Administrator, or Project Maintainer for the projects they maintain
Sync content from Bitbucket
Transifex syncs content from Bitbucket in two cases:
You save or update the integration settings in your project.
Transifex finds new content on Bitbucket after a commit to the branch linked to the integration.
To see a sync in progress, go to your project Settings > Integrations > Bitbucket > Manage. A sync can take some time, depending on the number and size of the files.
The Bitbucket integration page shows an activity log of all sync operations with Bitbucket. Use it to find files that failed to sync or could not be found.
Sync content from Transifex
If the file format of a resource allows it, a Project Maintainer or Organization Administrator can edit the resource directly in the Transifex Editor, whether or not the resource came from a Bitbucket repository. Use this for quick corrections, such as fixing a spelling or punctuation mistake.
Transifex syncs the change back to Bitbucket automatically, either as a new pull request (PR) or as a direct commit to the original branch. Developers don't need to retrieve the updated resources from Transifex and push them to Bitbucket by hand.
The activity log records each of these syncs.
Commits and pull requests from Transifex
The integration creates commits and pull requests in your repository as the Transifex bot. To add a prefix to commit messages or pull request titles, see Bitbucket: Installation and configuration.
Connect resources that already exist in Transifex
If your localization process is already running and your resources exist in Transifex, you can connect them to the matching files in Bitbucket. A resource is what Transifex stores for each file. The integration identifies the resource for a Bitbucket file by its slug, so you set each existing resource's slug to a hash of that file's location.
In your Bitbucket repository, find the files that match your existing Transifex resources, on the branch linked to the integration.
For each file, note these three values:
The repository name as the Bitbucket integration page shows it, for example
transifex/Bitbucket-Transifex-Integration.The branch name, for example
master.The full path of the file from the repository root, without a leading slash, for example
source/product_A.json.
Combine them into one line of text with this pattern:
bitbucket#<repository>#<branch>#<file_path>
For example:
bitbucket#transifex/Bitbucket-Integration#master#source/product_A.json
Generate the md5 hash of that text on your own computer.
printf '%s'prints the text without adding a line break, which would change the hash.
On macOS:printf '%s' 'bitbucket#transifex/Bitbucket-Integration#master#source/product_A.json' | md5
On Linux:printf '%s' 'bitbucket#transifex/Bitbucket-Integration#master#source/product_A.json' | md5sum
The hash is the 32-character value at the start of the output. For this example, it is36f2065f390dd4a74a73bbb4a9268734. Avoid online MD5 generators: many send the text you enter to their server, which shares your repository and file names with a third party.In Transifex, open each resource's settings and set its slug to the hash.
Check the status of the integration
Changes on the Bitbucket side can affect the integration and stop Transifex and Bitbucket from exchanging content. This happens when:
The linked branch is deleted.
You set up the integration with a YAML configuration file, and that file is corrupt or missing from the repository. See Bitbucket: Installation and configuration for how the file works.
The integration owner is the Project Maintainer or Organization Administrator who installed it in the project. The owner learns about the integration's health in two ways:
On the Bitbucket integration page, the connection status indicator changes from green to red.
The owner receives an automated email asking them to investigate the cause.
💡 Tip
Looking for more help? Get support from our Transifex Community Forum!
Find answers or post to get help from Transifex Support and our Community.