Branching in LingoHub enables localization teams to work seamlessly alongside software developers using Git repository branches.
Developers frequently create temporary branches (e.g., feature-login-page, feature1, feature2, ...) to build new features without affecting the main codebase. Branching allows translators and LINA to localize these new feature copy strings in parallel. Once development and translation are complete, the code and its localized content can be merged into main simultaneously.
Important requirements & limits
Integration compatibility: Branching is available for Git repository integrations (GitHub, GitLab, Bitbucket, and Azure DevOps). It is not available for API-based integrations like Figma, Storyblok, or Zendesk.
Branch limit: Each project supports up to 20 synchronized branches. Contact [email protected] if your team requires a higher limit.
Overview & manual branch management
To view and manage your project branches, navigate to Projects. Select your project, then go to Settings and choose the Branches tab.
Managing existing branches
In the branches table, locate any branch and click the three-dots menu icon on the right side of its row. Here you have the following options:
Set branch as default. We highly recommend using
mainas your default branch.
Edit: Rename the LingoHub branch.
Disconnect from GitHub: Unlinks the LingoHub branch from its repository target without deleting local content.
Connect to GitHub: (Re-)connects an unlinked LingoHub branch to an existing repository branch.
💬 Please note: The target branch must already exist in your Git repository to be able to link it in LingoHub.
Restore from branch: Overwrites the current branch's keys, texts, and context data using data from another branch.
Creating a branch manually
On the Branches settings tab, click + Create branch.
Enter a Name for your branch (e.g.,
feature1).Select a Connection type.
Starting point (LingoHub branch): Uses an existing LingoHub branch as your base.
Git branch: Connects directly to a branch in your Git repository (as long as it is available there).
Click Create branch.
Manual pull and push workflow
Pulling files from Git
To import updated files from your repository into a branch:
Click the Git integration dropdown in the top-right corner and click Pull.
Select your target LingoHub branch and optional Repository branch.
Choose specific files and target languages or leave set to All, then click Pull.
Pushing files to Git
To export translations back to your repository:
Click the Git integration dropdown in the top-right corner and click Push.
Select your Push type.
Create pull request (Recommended): Creates a pull request in Git for review before merging into the target branch.
Push directly: Commits translations directly to the specified target branch.
Select your source LingoHub branch and Pull request base branch (e.g.,
main).
Keep PR metadata as is or change it according to your needs and click Push.
Automated branching synchronization
Rather than creating branches manually, you can set up automated branch synchronization to match your Git workflow.
Enabling and configuring automated branches
Go to Settings, then Integration (GitHub/GitLab/Bitbucket/Azure).
Under Branches & Files, switch the Branches toggle to the right = ON.
Click Configure.
Define your matching rules using the Include or Exclude button (appears by hovering over an element in the list) or by entering wildcards (e.g.,
Include = feature**).
OR
Click Apply & sync.
⚠️ Important: Disabling the main Branches toggle under Integration settings will permanently delete all non-default branches and their segment data from your LingoHub project, including all manually created branches.
Working with branches in the Editor & Languages view
Switching branches in the Languages view
In your project Languages view, click the branch dropdown next to your project name in the top header to switch views between branches (e.g., main, feature1).
Filtering and creating segments in the Editor
Filtering by branch: Open the Editor, click the project selection dropdown in the top search bar, and select your specific project branch (e.g.,
Projekt with Branches/feature1).
Adding new segments: When clicking + New segment in the Editor, ensure you select the correct target branch from the Select branch dropdown before saving.
Need more help?
Couldn't find what you were looking for? Reach out to our team at [email protected], and we will gladly assist you.