GitLab Integration with PTC

+

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

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.

Grant Access to Your Repository

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

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).

Required role

Maintainer

Scopes

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

Group Access Token

Creating the token

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

Required role

Maintainer

Scopes

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

Creating the token

Required role

Scopes

Project Access 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).

Maintainer

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

Group Access Token

Personal access tokens in Developer Settings

Important: Creating a fine-grained access token may be restricted by your organization’s access policies. If you can’t create the token, ask an organization admin to review the Personal Access Token Policy settings in GitHub.

Maintainer

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.

Select Your Repository and Branch

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.

Translate Automatically with PTC

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.

Review and Accept the Merge Request

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

Scroll to Top