Bitbucket (Strings)

Content is machine translated from English by Phrase Language AI.


For information about Bitbucket integration in Phrase TMS, refer to Bitbucket Cloud (TMS).

  • Bitbucket Sync is only supported for Bitbucket Cloud. It cannot be used with Bitbucket Server.

  • Bitbucket Sync can be used via API.


  • The .phrase.yml configuration file must be present in the root of the branch to be monitored. The file defines which files to import (pull) or export (push) from the repository.

  • Read and write access are required for the repository.

  • Incorrectly defined configuration files may cause errors. Ensure that the file contains at least one push and one pull target, correct file formats and the correct setting of the update_translations parameter.

Sample configuration file:

    project_id: 1f61b9ecdb7a17a9dd174302419c50cc
    file_format: simple_json
            - file: ./<locale_name>.json
            - file: ./<locale_name>.json

Project ID of a project is found in project settings.

Connect Repositories

Once the configuration file is in place, to connect a repository, follow these steps:

  1. From the Integrations page, scroll down to the Bitbucket Sync connector and click Activate.

    The Bitbucket Sync activation page opens.

  2. Select the Bitbucket account to be connected from the Authorize for workspace dropdown list and click on Grant access.

    The connection between Phrase Strings and the selected Bitbucket account is established.


    It is not possible to connect multiple accounts via the Bitbucket integration.

  3. Click Connect repository.

    The Connect repository window opens.

  4. Select a repository from the dropdown list and click Save.

    The repository is added to list of connected repositories and an access token is automatically created.

If repository ownership is not correct, the repository will not be visible in the dropdown list.

Integrations can be deactivated or removed from the Integrations page. To remove a Bitbucket integration, follow these steps:

  1. If removing an integration set up by another user, delete the user profile who set up the connection in Phrase Strings.

  2. Access Bitbucket with Admin rights and completely remove the integration.

  3. Log into Phrase Strings and set up the integration again.

Import to Bitbucket

After activating Bitbucket Sync and connecting a repository, local files can be imported. This is done in the form of pull requests so changes can be reviewed and branch management can be controlled.

To import local files to BitBucket, follow these steps:

  1. From the Bitbucket account, select a repository for synchronization.

  2. Select a branch of the repository and from the context menu, select Import from Phrase.

    Translations are pulled into the repository.

  3. Approve, merge or close the pull request in Bitbucket.

Export from Bitbucket

To export locale files from Bitbucket, follow these steps:

  1. From the Bitbucket account, select a repository to be synchronized.

  2. Select a branch of the repository and from the context menu, click Export to Phrase.

    Translations are pushed into the project. Keys and current translations are updated.

  3. Click on an upload in the list or from Uploads in the project to see a detailed upload summary.

    Successful uploads are indicated with a green icon and failed uploads are indicated with a red icon.

Was this article helpful?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.