Triggers reference
Field reference for Configure triggers.
Event types
| Event Type | Triggers When | Use Case |
|---|---|---|
| Push | A new commit is pushed. | Continuous integration. |
| Merge Request | A merge request is created or updated. | Code review validation. |
| Tag | A new Git tag is created. | Release Pipeline. |
Applied to branches — options
| Option | Fields | Behavior |
|---|---|---|
| All branches | None | Every branch matching the selected events triggers the Pipeline. Default. |
| Filtered branches by name | Name included, Name excluded | Add one or more branch names to each list (press Enter to add). Leave Name included empty to match all branches except those in Name excluded. |
| Filtered branches by regex | Source Branch Regex, Target Branch Regex | Enter a regular expression per field. Not validated as you type — check syntax before saving. See examples below. |
Only one option applies at a time.
Branch Filter — Regex examples
| Regex | Meaning |
|---|---|
^main$ | The main branch only. |
^(develop|staging)$ | The develop or staging branch only. |
.*feature.* | All branches containing feature. |
.*release.* | All branches containing release. |
.*debug.*|.*release.* | Branches containing debug or release — the pattern shown as an example in the UI. |
Webhook elements
| Element | Description |
|---|---|
| Webhook URL | The endpoint that receives events from GitLab. |
| Secret token | The Webhook authentication code. Masked by default — use the visibility toggle to reveal it. |
| Copy | Copies the value to the clipboard. |
| Regenerate token | Issues a new Secret token and invalidates the old one immediately. |