Skip to content

GitHub Issues Setup

Automatically create GitHub issues when users submit feedback on your support pages. Bug reports, feature requests, and questions — all tracked in your repo.

How labels work

Every issue gets a feedback label. Bug reports also get bug, and feature requests get enhancement. Labels are created automatically if they don't exist in your repo.

Setup steps

1

Create a fine-grained personal access token

Go to GitHub Settings → Developer settings → Fine-grained tokens and click Generate new token.

2

Configure token permissions

Repository access: select Only select repositories and pick the repo where issues should be created.
Permissions: under Repository permissions, set Issues to Read and write. Metadata is automatically set to Read-only. Works with both public and private repos.

3

Copy the token

Click Generate token and copy it immediately — GitHub only shows it once.

4

Add the repository in SupportDock

Go to your app in the console, open the Contact tab, and find the GitHub Issues section. Enter your repository in owner/repo format (e.g. myorg/myapp). You can also paste a full GitHub URL — it will be converted automatically.

5

Paste the token and save

Paste the personal access token into the token field and hit Save.

6

Done

When users submit feedback, a GitHub issue is created automatically in your repo.

Token permissions summary

SettingValue
Token typeFine-grained personal access token
Repository accessOnly select repositories
Issues permissionRead and write
Metadata permissionRead-only (auto-set by GitHub)

Using a fine-grained token scoped to a single repo with minimal permissions is the most secure approach.

What created issues look like

Each issue includes:

  • Title: [Feedback] followed by the subject
  • Labels: feedback always, plus bug or enhancement based on category
  • Body: sender name, email, app name, category, and full message

Example issue

[Feedback] App crashes on startup
feedbackbug

From: Jane Doe (jane@example.com)

App: Loan Reminder

Category: Bug

The app crashes immediately after opening on iOS 18.2. I've tried reinstalling but it still happens.

Ready to connect GitHub Issues?

Get started