Skip to main content

Connect Userback with GitHub

How to connect a Userback site to a GitHub repository so feedback becomes GitHub issues with screenshots and technical details attached.

Written by Jon

When you connect GitHub, feedback from your site is created as an issue in the repository you choose, with its annotated screenshot or recording, metadata and comments attached. This is a 1-way integration: changes to the issue in GitHub stay in GitHub.

Before you start

  • The repository must already exist. Userback can only choose from repositories the connected GitHub account can access.

  • Add your team to the repository in GitHub so they can see and work on the issues Userback creates.

Connect GitHub

  1. Go to Feedback > Settings > Integrations.
    ​

  2. On the GitHub card, click Connect.
    ​

  3. Sign in to GitHub and approve access.
    ​

  4. Choose the Default Repository new issues should go to.
    ​

  5. Choose when feedback is sent: Manually, Automatically, or Automatically and Resolve in Userback. For the automatic options, pick which feedback types to include.
    ​

  6. Click Test. A test issue appears in the repository. Check it, then close or delete it.

Send feedback to GitHub manually

If you chose Manually, open a feedback item (or its notification in your Inbox), click Send to GitHub, confirm the repository, and click Send.

Troubleshooting

My repository isn't in the list

The GitHub account you authorized with needs access to it. If the repository belongs to an organization, check the organization allows the Userback app access. Then reopen the GitHub settings in Feedback > Settings > Integrations.

Issues stopped appearing in GitHub

Reconnect GitHub from Workspace Settings > Connected Apps if the connection has expired, then check Workspace Settings > Integration Log for the error on any failed request.

What's next

Related articles

Did this answer your question?