TriggerGitLabReal-timeUpdated June 2026

When does GitLab fire on git tags?

Short answer: In TinyCommand, add the GitLab GitLab Tag Pushed trigger to a workflow and publish. It listens through a GitLab webhook and fires your workflow within seconds of the event, with no polling and no code. Add a filter if you only want some events to start a run.

Trigger workflows on GitLab Tag Pushed in GitLab — start free All 5 GitLab triggers

Trigger workflows on GitLab Tag Pushed in GitLab — start free

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder

Trigger

GitLab Tag Pushed

When the matching event happens

watch for tag pushedwhen tag pushedon tag pushednew tag pushedwhen a tag is pushed to a gitlab repository

What this trigger returns

for the curious

You don’t need to read this. TinyCommand auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
  "tag": "v1.0.0",
  "author": "developer",
  "project": "group/project"
}

Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

Field	Type	Example
tag	string	"v1.0.0"
author	string	"developer"
project	string	"group/project"

Pairs with

Drop these actions after GitLab Tag Pushed.

Add Labels to Message

Gmail · Email

Add Reaction

Slack · Communication

Add Sheet Tab

Google Sheets · Spreadsheets & Databases

Create Company

HubSpot · CRM & Sales

FAQ

Questions about GitLab Tag Pushed.

How does the GitLab Tag Pushed trigger work in GitLab?

Fires when a new tag is pushed. Useful for release-management workflows that fire on version tags (e.g., "v1.2.3 pushed → trigger production deploy").

Is the GitLab Tag Pushed trigger real-time?

Yes. GitLab Tag Pushed uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in GitLab.

What data does GitLab Tag Pushed return?

The full event payload from GitLab. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.

Can I filter GitLab Tag Pushed so only some events start a workflow?

Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.

Do I need GitLab admin permissions to use GitLab Tag Pushed?

For most GitLab accounts a standard user can authorize the trigger. Some GitLab plans require an admin to enable third-party webhooks. Check GitLab's docs if the trigger fails to register.