Workflow Triggers
Triggers control when LocoLingua runs a translation job against your repository. Some triggers fire automatically in response to VCS events; others are initiated by hand from the portal. The table below lists every trigger, its current status, and which VCS providers support it.
Trigger Reference
Triggers marked Available are fully supported today. Triggers marked Coming Soon are on the roadmap and will be announced when released.
| Trigger | Status | Supported VCS Hosts | Description |
|---|---|---|---|
| Manual | Available | GitHub GitLab | Run a translation job on demand from the LocoLingua portal. Translations are committed to a new branch and, optionally, a pull or merge request is opened against your default branch. |
| Pull Request / Merge Request | Available | GitHub GitLab | Automatically trigger a translation run whenever a pull request (GitHub) or merge request (GitLab) is opened or updated against your default branch. Keeps locales in sync with every code change without manual intervention. |
| Scheduled (Cron) | Coming Soon | GitHub GitLab Bitbucket | Run translation jobs on a defined schedule — for example, nightly or weekly — so locale files are always up to date without requiring a code event. |
| Push to Branch | Coming Soon | GitHub GitLab Bitbucket | Trigger a translation run whenever a commit is pushed to a specified branch (e.g., main or release/*). Useful for teams that merge frequently and want translations generated continuously. |
How Each Trigger Works
Step-by-step explanation of the sequence of events for each trigger type.
Manual
AvailableRun a translation job on demand from the LocoLingua portal. Translations are committed to a new branch and, optionally, a pull or merge request is opened against your default branch.
- User initiates a translation run from the portal.
- LocoLingua clones the repository and extracts translatable strings.
- Translated locale files are committed to a new branch.
- A pull request (GitHub) or merge request (GitLab) is opened for review.
Pull Request / Merge Request
AvailableAutomatically trigger a translation run whenever a pull request (GitHub) or merge request (GitLab) is opened or updated against your default branch. Keeps locales in sync with every code change without manual intervention.
- A pull or merge request is opened or synchronized in your repository.
- The VCS provider sends a webhook event to LocoLingua.
- LocoLingua checks out the PR branch and extracts new or changed strings.
- Updated locale files are committed back to the same PR branch.
Scheduled (Cron)
Coming SoonRun translation jobs on a defined schedule — for example, nightly or weekly — so locale files are always up to date without requiring a code event.
- User configures a cron schedule in the LocoLingua portal.
- At the scheduled time, LocoLingua checks the default branch for untranslated strings.
- Translated locale files are committed and a pull or merge request is opened if changes exist.
Push to Branch
Coming SoonTrigger a translation run whenever a commit is pushed to a specified branch (e.g., main or release/*). Useful for teams that merge frequently and want translations generated continuously.
- A commit is pushed to a configured branch.
- The VCS provider sends a push webhook event to LocoLingua.
- LocoLingua extracts new strings and commits updated locale files to a translation branch.
- A pull or merge request is opened for review.
Don't see your VCS host or trigger type? Let us know what you'd like us to support.