# GitLab Integration

Source: https://docs.qualflare.com/docs/integrations/gitlab · Last updated: 2026-11-06

Connect Qualflare to GitLab.com to file GitLab issues automatically for new defects, failed test runs, failure clusters and flaky tests.

The GitLab integration files GitLab issues from Qualflare. When an event you selected happens in a project, such as a new defect, Qualflare creates an issue in the GitLab project you chose. It works one way: nothing you do in GitLab changes Qualflare.

It works with GitLab.com only. Self-managed GitLab instances can't be connected.

## Setup

### Step 1: Install the GitLab Integration

1. In the workspace sidebar, open **Integrations**. You need a workspace role of **Editor** or higher
2. Find **GitLab** under **CI/CD**
3. Click **Install**
4. Sign in to GitLab.com and authorize Qualflare. It asks for the `api` scope
5. The integration is installed at the workspace level

### Step 2: Connect a GitLab Project

1. In the project sidebar, open **Integrations**. You need the **Editor** role or higher on the project
2. Click **Configure** on the GitLab integration
3. Select the **Project**. Optionally add **Labels**
4. Under **Events**, select the events that should create an issue
5. Click **Save**

## What the Issue Contains

For a defect, the issue title is `[Defect #12] <defect name>`. The body lists the defect's severity, environment, category, status, team and root causes when they are set, then the description and the expected and actual results. It ends with *Created automatically by Qualflare*. Your **Labels** are applied.

The issue has no link back to Qualflare. Instead, the defect shows the new issue under **Linked issues**.

## Events

| Qualflare Event     | GitLab Issue Title               |
| ------------------- | -------------------------------- |
| Defect Created      | `[Defect #12] <defect name>`     |
| Launch Failed       | `[Launch #48] Failed — <status>` |
| Cluster Created     | `[Cluster] <cluster name>`       |
| Flaky Test Detected | `[Flaky] <test case name>`       |

**Launch Failed** fires when results uploaded with the CLI, a reporter or the API include a failed, error, timed-out or aborted test. Qualflare only creates issues. It does not close, reopen, update or comment on them.

## Disconnecting

> **Caution:** Removing GitLab deletes every project's GitLab settings. If the card shows **Reconnect**, GitLab no longer accepts Qualflare's access, and the only fix is to remove the integration, install it again and set up each project from scratch.

To remove the GitLab integration, open **Integrations** in the workspace sidebar, click the trash icon on the GitLab card, then click **Remove**.

## See Also

* [Integrations Overview](https://docs.qualflare.com/docs/integrations)
* [Defects](https://docs.qualflare.com/docs/defects)
