Link GitLab issues and merge requests to your Flagsmith feature flags. When a flag changes state, Flagsmith posts a comment to the linked issue or MR showing the flag's current state across all environments.

Setup

The integration requires a token with access to the full GitLab group — either a personal access token or a group access token. Project access tokens are not supported yet.

1. In GitLab
   1. Create a personal access token or group access token with the api scope.
   2. Copy the token — you will not see it again.
2. In Flagsmith
   1. Go to Integrations > GitLab > Add Integration.
   2. Set the GitLab Instance URL to your instance (e.g. https://gitlab.example.com or https://gitlab.com).
   3. Enter your GitLab Group (e.g. my-company).
   4. Paste the access token.
   5. Click "Save". ✅

tip

Remember to rotate your GitLab access token before it expires.

Linking issues and merge requests to feature flags

1. Open a feature flag and go to the Link tab.
2. Select a GitLab project from your connected group.
3. Choose Issue or Merge Request.
4. Search and select the item you want to link.

Flagsmith will post a comment to the linked issue or MR with the flag's current state across all environments. When the flag state changes, a new comment is posted automatically.

A Flagsmith Flag label is added to linked issues and merge requests so your team can filter for them in GitLab.

Automatic state sync

When a linked issue or merge request changes state in GitLab — closed, merged, or reopened — Flagsmith automatically updates the linked feature flag's tags to reflect the current state. This is powered by webhooks that Flagsmith registers on your GitLab projects automatically.

Removing the integration

Go to Integrations > GitLab > Manage Integration > Delete Integration.