Repository Integration

GitLab Integration with PTC

+

PTC integrates with your GitLab repository to automate localization and keep translation files updated with every resource file change.

Try PTC for Free

Automate the Translation of Files

Once connected to GitLab, PTC automatically detects and translates your resource files. Translated files are sent back to your repository via merge requests, ready for review and approval. You maintain control by using the GitLab workflow you already know and trust.

Eliminate Manual Work

PTC saves development time by monitoring your repository, updating translation files as you push changes, and sending updated translations via merge requests. This continuous localization keeps your project moving and speeds up product releases.

Improve Accuracy and Reduce Errors

By staying connected to your repository and automating translation updates, PTC eliminates the risk of human errors like misplaced keys or outdated translations.

How to Set Up the PTC and GitLab Integration 

To get started, log in to your PTC account or create one. When you create a new project, the PTC setup wizard will guide you through the integration process.

PTC integrates with both GitLab.com and self-hosted GitLab repositories. For self-hosted GitLab, you’ll need to provide your GitLab instance URL.

We recommend using OAuth as your authentication method.

If needed, you can use a project access token or a group access token instead. These tokens must include the correct permissions:

Project Access Token

Group Access Token

What Needs Translating?

Creating the token

In your project, go to Settings → Access Tokens. Give the token a name, an optional description, and set an expiry date (recommended for security).

In your group, go to Settings → Access Tokens. Give the token a name, an optional description, and set an expiry date (recommended for security).

What Needs Translating?

Required role

What To Do

Maintainer

Maintainer

What Needs Translating?

Scopes

What To Do

api → Allows PTC to read from and push to the repository

api → Allows PTC to read from and push to the repository

After generating the token, store it securely and add it during the PTC project setup.

PTC pulls all your repositories and branches. Select the repository you want to connect to PTC and the branch where changes will be monitored and translations managed.

PTC scans your repository to identify resource files in your project. Once you provide project details and select your target languages, PTC generates Better Than Human Translations for your files.

PTC delivers translations via merge requests. Review, approve, and merge them in GitLab.
From then on, you can continue pushing updates, and PTC will send updated translations via new merge requests.

Frequently Asked Questions About the GitLab Integration

Why does PTC need read and write access to my repository?

PTC uses read access to detect changes in your resource files and write access to deliver translations via pull requests. PTC only interacts with the files it manages for translation and does not make changes to any other parts of your repository.

Which Git hosting platforms are supported by PTC?

In addition to GitLab, PTC integrates with GitHub and Bitbucket, offering the same automated localization workflows and features for each platform.

What file formats does PTC support?

PTC works with a wide range of resource file formats, including .po, .mo, .json, .xml, .properties, .csv, .xlif, and more.

Repository Integration

Start typing and press enter to search

Scroll to Top