LingoHub’s Bitbucket integration enables a quick and smooth localization process for your repository files. To connect Bitbucket to LingoHub, you need to generate a repository access token with the required permissions, then configure authentication in your workspace. This article provides a detailed description of how to do this.
Create a Bitbucket Access token
Follow these steps to generate the required credentials in Bitbucket:
Sign in to your Bitbucket account, then navigate to the repository you want to connect to.
In the left-hand sidebar, go to Repository settings > Security > Access tokens.
Click Create access token.
Provide a Name for the token (e.g., "LingoHub").
Set an Expiry date.
Note: Per Bitbucket workspace policy, a token cannot be used for more than 365 days.
Select the following Scopes (permissions):
Repositories: Read and Write are often required for full synchronization.
Pull requests: Select Write to allow LingoHub to create pull requests with translated content.
Webhooks: Select Read and Write. This allows LingoHub to automatically synchronize new changes. Without this, you will need to trigger imports manually.
Click Create.
Copy the access token immediately and store it in a secure place. You will not be able to view or retrieve it once you close the window.
Note: The dialog box may show additional guidance for using the access token in Bitbucket. You can ignore these instructions as they are not relevant when connecting Bitbucket to LingoHub.
Connect Bitbucket to LingoHub
Once you have your token, you can add the authentication to your LingoHub workspace:
Navigate to Plugins and integrations.
Find the Bitbucket plugin and click Manage.
Click Add new Bitbucket authentication.
In the configuration window, provide the following:
Name: A label for this connection (e.g., "Main Bitbucket").
Access token: Paste the token you generated in Step 1.
Click Create.
Create a new LingoHub project
With the authentication configured, you can now link your repositories to a project:
Click Create project on your LingoHub dashboard.
Enter your Project name.
Under Select project category, choose Bitbucket.
Note: The Bitbucket integration is file-based. Platforms like Figma, Contentful, or Zendesk use different connection methods.
Click Continue and follow the prompts to select your specific repository and branch.
Managing your Bitbucket integration
Once your project is created, you can manage the synchronization settings at any time:
Open your project and navigate to the Settings tab.
Click on the Integration (Bitbucket) sub-tab.
From here, you can configure your Resource Filters to include or exclude specific file paths and set your Pull & Push automation rules.
This comprehensive Help Center article on managing your project repository integrations explains the most important settings.
Awesome! You have finished the article on setting up the Bitbucket integration. We hope that it helped you find answers to all your questions. Otherwise, contact our support, and we will gladly help!