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 supports personal access tokens, group access tokens, and project access tokens. All require the api scope. The token type determines which projects are accessible in Flagsmith.

1. In GitLab
   1. Create an 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. Paste the access token.
   4. 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.
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.