Skip to main content

GitHub: Manual syncing and editing

How to trigger a manual sync between Transifex and GitHub

Written by Antonis Mylonas

Send translations to GitHub on demand, and change which files and options your GitHub integration uses after setup.

🔒 Available on: All plans. Role required: Organization Administrator, or Project Maintainer for the projects they maintain

In this article, a resource is a copy of a repository file that Transifex stores in your project. The localization percentage is the share of a resource's strings that are completed in one target language.

Send translations to GitHub manually

Use Manual Sync to send translations to GitHub without waiting for a resource to be 100% translated, reviewed, or proofread.

  1. Go to your project Settings > Integrations > GitHub > Manage.

  2. Click Manual Sync.

    GitHub integration page showing the linked GitHub account, the Manual Sync button and the ellipsis menu above the linked repository

  3. In the Sync Manually window, enter the Threshold percentage. Transifex checks this localization percentage against all resources in your project.

    Sync Manually window with an empty Threshold percentage field and the Cancel and Sync buttons

  4. Click Sync.

Transifex syncs every target language at or above the threshold with GitHub, using the Sync content options you set up for the integration.

For example, suppose the integration creates a commit on the selected branch for 100% translated resources. If you run a manual sync with a threshold of 80%, Transifex creates one commit for each resource in each target language that is at or above 80%.

📝 Note: If you send less than 100% translated content, Transifex fills the untranslated strings with either an empty value or the source string, depending on the file format. This matches the download for use option in the Transifex user interface and the default mode in the Transifex CLI (tx) and the Transifex API.

To see how the default mode behaves for a specific file format, open that format in the File Formats collection.

Edit the integration settings

As your project evolves, you may want to sync more files or change how Transifex sends translations back to GitHub.

⚠️ Warning: If you remove an already synced file or directory from the YAML configuration, Transifex deletes the matching resources from your project, together with their translations and strings' metadata, such as review state, tags, and screenshot mappings. Existing translations stay available as Translation Memory suggestions while the project exists, as Deleting Resources explains.

  1. Go to your project Settings > Integrations > GitHub > Manage.

  2. Click the ellipsis (⋯) and select Edit settings.

    Ellipsis menu on the GitHub integration page with the Edit settings, Unlink and Link a new repository options

The editing page is the same one you used during setup, but you can only:

  • Change the YAML configuration to update which files Transifex syncs from the GitHub repository.

  • Change the options for how Transifex sends updates back to GitHub.


💡 Tip

Looking for more help? Get support from our Transifex Community Forum!

Find answers or post to get help from Transifex Support and our Community.

Did this answer your question?