# GitHub Issues integration

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

> Turn feedback into GitHub issues in a repository you control.

Turn feedback into GitHub issues in a repository you control.

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

![Configure the GitHub repository, delivery controls, and issue format in PushFeedback](./images/github-configuration.jpg)

## Before you start

- Create a [fine-grained personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) for the target repository. Grant it read and write access to **Issues**.
- Copy the repository owner and name from its URL: `github.com/<owner>/<repository>`.
- PushFeedback encrypts the token and never displays it again.

## Configure GitHub Issues

1. In the PushFeedback dashboard, open your project, then **Settings** > **Integrations** > **GitHub Issues**.
2. In **01 Connection and destination**, enter the token, repository owner, and repository name.
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 body with feedback and project variables.
5. Under **Advanced rules and custom fields**, add optional labels, assignees, 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 verify repository access without creating an issue.

## Delivery behavior

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

## Remove GitHub Issues

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