# GitLab Issues integration

> For the complete documentation index, see [llms.txt](/llms.txt)

> Turn feedback into issues in a GitLab.com project you control.

Turn feedback into issues in a GitLab.com project you control.

:::info
GitLab Issues is available on the [Professional](https://pushfeedback.com#pricing) and [Unlimited](https://pushfeedback.com#pricing) plans.
:::

![Configure the GitLab project, delivery controls, and issue format in PushFeedback](./images/gitlab-configuration.jpg)

## Before you start

- Create a [GitLab personal access token](https://docs.gitlab.com/user/profile/personal_access_tokens/) that can access the target project and create issues.
- On the project's overview page, open **Actions** and select **Copy project ID**. You can also use the full project path, such as `group/project`. See [GitLab's project ID guide](https://docs.gitlab.com/user/project/working_with_projects/#find-the-project-id).
- If you want to assign new issues automatically, use the [GitLab Users API](https://docs.gitlab.com/api/users/#list-users) to find the user's numeric `id`.
- PushFeedback encrypts the token and never displays it again.

## Configure GitLab Issues

1. In the PushFeedback dashboard, open your project, then **Settings** > **Integrations** > **GitLab Issues**.
2. In **01 Connection and destination**, enter the access token and project ID or path.
3. In **02 Delivery controls**, keep **Enabled** selected or pause delivery without losing the configuration. Select **Require a message** to skip rating-only feedback.
4. In **03 Message recipe**, customize the issue title and description with feedback and project variables.
5. Under **Advanced rules and custom fields**, add optional labels, an assignee user ID, and delivery rules.
6. On wider screens, review the live issue preview while you edit. It does not create an issue.
7. Save the integration, then select **Test connection** to validate the saved token and project. It does not create an issue.

## Delivery behavior

When the integration is enabled, feedback matching your delivery controls and rules creates an issue in the configured GitLab project.

## Remove GitLab Issues

Open the GitLab Issues integration settings and select **Remove integration**.