Matrix
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
You can configure GitLab to send notifications to a Matrix room.
Set up the Matrix integration in GitLab
After you join to a Matrix room, you can configure GitLab to send notifications:
- To enable the integration:
- For your group or project:
- On the left sidebar, select Search or go to and find your project or group.
- Select Settings > Integrations.
- For your instance:
- On the left sidebar, at the bottom, select Admin area.
- Select Settings > Integrations.
- For your group or project:
- Select Matrix.
- Under Enable integration, select the Active checkbox.
- Optional. In Hostname, enter the hostname of your server.
- In Token, paste the token value from the Matrix’s user.
- In the Trigger section, select the checkboxes for the GitLab events you want to receive in Matrix.
- 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. From the Branches for which notifications are to be sent dropdown list, select the branches you want to receive notifications for.
- Optional. Select Test settings.
- Select Save changes.
The Matrix room can now receive all selected GitLab events.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support