Matrix

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

{{< history >}}

• Introduced in GitLab 17.3.

{{< /history >}}

You can configure GitLab to send notifications to a Matrix room.

Set up the Matrix integration in GitLab

Prerequisites:

• Administrator access for instance enablement.
• The Owner role for group enablement.
• The Maintainer or Owner role for project enablement.

After you join to a Matrix room, you can configure GitLab to send notifications:

1. To enable the integration:
   • For your group or project:
     1. In the top bar, select Search or go to and find your project or group.
     2. Select Settings > Integrations.
   • For your instance:
     1. In the upper-right corner, select Admin.
     2. Select Settings > Integrations.
2. Select Matrix.
3. Under Enable integration, select the Active checkbox.
4. Optional. In Hostname, enter the hostname of your server.
5. In Token, paste the token value from the Matrix's user.
6. In the Trigger section, select the checkboxes for the GitLab events you want to receive in Matrix.
7. In the Notification settings section:
   • In Room identifier, paste the Matrix room identifier.
   • Optional. Select the Notify only broken pipelines checkbox to receive notifications for failed pipelines only.
   • Optional. Select the Notify only when status changes checkbox to receive notifications only when the pipeline status for the ref changes.
   • Optional. From the Branches for which notifications are to be sent dropdown list, select the branches you want to receive notifications for.
8. Optional. Select Test settings.
9. Select Save changes.

The Matrix room can now receive all selected GitLab events.