Triggers

  • Tier: Premium, Ultimate
  • Add-on: GitLab Duo Core, Pro, or Enterprise
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
  • Status: Experiment

A trigger determines when a flow runs.

You specify the service account that runs the flow, and which conditions make the flow run.

For example, you can specify flows to be triggered when you mention a service account in a discussion, or when you assign the service account as a reviewer.

Create a trigger

Prerequisites:

  • You must have at least the Maintainer role for the project.

To create a trigger:

  1. On the left sidebar, select Search or go to and find your project. If you’ve turned on the new navigation, this field is on the top bar.
  2. Select Automate > Triggers.
  3. Select New flow trigger.
  4. In Description, enter a description for the trigger.
  5. From the Event types dropdown list, select one or more event types:
    • Mention: When the service account user is mentioned in a comment on an issue or merge request.
    • Assign: When the service account user is assigned to an issue or merge request.
    • Assign reviewer: When the service account user is assigned as a reviewer to a merge request.
  6. From the Service account user dropdown list, select the service account user.
  7. For Configuration source, select one of the following:
    • AI Catalog: From the flows configured for this project, select a flow for the trigger to execute.
    • Configuration path: Enter the path to the flow configuration file (for example, .gitlab/duo/flows/claude.yaml).
  8. Select Create flow trigger.

The trigger now appears in Automate > Triggers.

Edit a trigger

  1. On the left sidebar, select Search or go to and find your project. If you’ve turned on the new navigation, this field is on the top bar.
  2. Select Automate > Triggers.
  3. For the trigger you want to change, select Edit flow trigger ( pencil ).
  4. Make the changes and select Save changes.

Delete a trigger

  1. On the left sidebar, select Search or go to and find your project. If you’ve turned on the new navigation, this field is on the top bar.
  2. Select Automate > Triggers.
  3. For the trigger you want to change, select Delete flow trigger ( remove ).
  4. On the confirmation dialog, select OK.