Bitbucket Integration with PTC
Set up Bitbucket localization by integrating with PTC. Get human-quality translations to your repository via automated pull requests.
How To Integrate Bitbucket with PTC
PTC integrates with your Bitbucket repository to keep your resource files translated continuously. As you push code changes, PTC:
- Translates the updated strings
- Delivers the translations straight to your repository as a pull request
Bitbucket integration is a Pro feature. It becomes available when you activate Pay-As-You-Go.
Connect Bitbucket to PTC
To set up the Bitbucket integration, choose the option that applies to you:
- When creating a new project in PTC, select Git Integration in the setup wizard.
- To switch an existing project from manual file uploads to a continuous Git-based workflow, go to Settings → Merge Requests and click Add Git Integration.
In both cases, you’ll see a screen asking you to enter the URL to your repository. PTC will automatically detect that you’re using Bitbucket.
To connect your repository, you can use an access token (recommended) or sign in with OAuth. If you connect using an access token, make sure it includes the correct scopes.
Creating the Token
Go to Repository settings. Under Security, select Access tokens and click Create access token. Give the token a name and set an expiry date (recommended for security).
Select the required scopes:
| Scope | Access |
|---|---|
| Repositories | Read and Write |
| Pull Requests | Read and Write |
| Webhooks | Read and Write |
Once PTC validates the token, choose which branches you want it to monitor. PTC automatically detects the resource files in the selected branch.
Translate Your Project with PTC
After linking your Bitbucket repository to PTC, continue through the setup steps to tell PTC about your project and add languages.
PTC can import and reuse any translation files already in your Bitbucket repo. However, the best results come from translating the full project with PTC.
Review Pull Requests
PTC completes translations in just a few minutes and delivers them to your Bitbucket repository as a pull request. You can merge the changes immediately.
As you update monitored files, PTC automatically detects changes and opens new pull requests with the latest translations. This keeps your Bitbucket project fully localized over time.
How to Generate New Pull Requests Manually
You can manually trigger a new pull request from the Dashboard or the Translations tab, where you can view and make changes to translated text.
For example, if a translation exceeds the length limit, PTC highlights it so you can shorten it manually or ask PTC to generate a more compact version. Once you save the change, generate a new pull request to push the updated translations into your Bitbucket repository.
Make Sure PTC Translates Any New Resource Files
As your project grows, you may add new resource files to your repository. To bring them into PTC:
- Go to Settings → Monitored Files and click Rescan your repository.
- Any new files found will appear as drafts. Click the + icon to add a file to your translation workflow, then hit Save with translation to apply.
If you prefer not to review new files manually, select the Automatically include new translation files checkbox. PTC will then monitor and include newly discovered resource files in your repository without requiring confirmation.
Why Translate Bitbucket Projects With PTC
Quick and Easy Repository Integration
Connect PTC directly to your Bitbucket repository and eliminate the need for manual file imports or exports or for running fragile scripts. Once integrated, PTC detects resource files, generates human-quality translations using AI, and sends them back via pull requests.
Always Up-to-Date Translations
PTC tracks changes to your resource files and updates translations automatically. No extra effort from your team required.
Agile and Scalable Localization
PTC supports multiple languages and works with all major resource file formats. Choose which branches to monitor, and adjust settings as your project grows or changes.
Repository Access Stays Limited to Your Translation Files
PTC uses read access to detect changes in your resource files and write access to deliver translations via pull requests. It only interacts with files used for translations and doesn’t modify other parts of your repository.
The Same Workflow Works Across Bitbucket, GitLab, and GitHub
In addition to Bitbucket, PTC integrates with GitLab and GitHub, offering the same automated localization workflows and features across all platforms.
Built for Software and Mobile App Localization
PTC is built for development teams localizing software products and mobile apps. By connecting your Bitbucket repository, PTC picks up new or updated strings automatically and returns completed translations via merge request.
PTC supports the file formats common in these projects, including PO files and JSON files. To learn more about how PTC supports these workflows, visit our software localization and mobile app localization pages.
No Extra Charge for Connecting Your Repository
Connecting your Bitbucket repository doesn’t cost anything extra. PTC has no subscriptions or per-feature pricing. You simply sign up for Pay-As-You-Go and pay for the words you translate, with the first 500 words free every month. See the pricing page for the full breakdown.