Knowledge Base

Documentation on how to translate software with POEditor

If you want to connect your POEditor account with a GitHub account to more easily manage the localization of language files hosted on this code hosting service, follow the steps described below.

How to connect POEditor to your online GitHub account

Go to Account Settings in POEditor and access the Integrations tab.

Integrations page

Click on GitHub and then click the Connect button. Log in to your GitHub account (if you aren't) and authorize the POEditor app.

GitHub integration page - POEditor app localization tool

In the GitHub Integration page, select a localization project from your POEditor account and a language in this project. Link the language to the desired file in your GitHub repo.

Link POEditor project language to GitHub file

How to connect POEditor to GitHub Enterprise

If you have GitHub Enterprise installed on your server, you'll need to manually enter the server URL and token. Fill in the form in the GitHub Integration page with the Git Server URL (the URL of the API endpoint of your installed GitHub version) and the Access Token (you can generate one in your GitHub account in Settings > Personal Access Tokens) and press Connect.

Connect to GitHub Enterprise - POEditor app localization tool

Managing translations and syncing the language files

Each linked language file has several non-automated options in the GitHub Integration page:

Get terms - Imports your terms from the GitHub file to the selected POEditor language
Import translations from GitHub - Imports translations from your GitHub repository to the language in your POEditor project. If the project doesn't have any terms, you'll need to get the terms from GitHub first, and then import the translations.
Export to GitHub - Exports your terms and translations from the linked language to the file selected by you in the linking stage.
Add import rule - Adds a rule by which to tag strings on import.
Add export filter - Adds a rule by which to export strings.
Remove Link - Deletes the link between the POEditor language and the GitHub repo

GitHub integration options - POEditor app localization tool

You can automatically sync the terms whenever you make changes in your repos with GitHub webhooks. Here's some info about using webhooks with POEditor.

Note: If you're a member of a GitHub organization and want to use its repos, you have to request permission from the GitHub organization admin (unless the admin has changed the default access policy), in the same page you authorize POEditor to access your repos. For privacy reasons, only the person owning the GitHub account can manage language files in GitHub repos. Administrators can't do this in the name of the owner who set the credentials.