# GitHub Issues

Open a GitHub issue from each submission, in the repository you pick. Write your own title and body templates, and insert answers with @ mentions.

## What you get

- One GitHub issue per submission, created in your name
- Title and body templates. Type **@** to insert a field value.
- GitHub-flavored markdown in the body: bold, lists, headings, code blocks, and links
- An optional milestone for every issue

## Connect GitHub

1. **Open Integrations**

   Click Integrations in the form's top bar, then pick GitHub Issues. Click **Connect GitHub account**, or pick an account the workspace already connected.

2. **Account and repository**

   The list shows repositories you can push to. Archived and disabled repositories do not show.

3. **Issue**

   Pick a milestone for every issue, if you like; it resets when you change the repository. Then write the title and body: type @ to insert field values or submission metadata such as PDF Link. The title is plain text, up to 256 characters. The body is GitHub-flavored markdown.

4. **Unfinished drafts (optional)**

   Under **More options**, on Pro and Business, pick an idle window and write a title and body for unfinished drafts. Leave it Off to skip.

5. **Turn it on**

   Click **Turn on GitHub Issues**, then **Send test** to create a real issue with a \[Test] prefix in the repository. Close or delete it afterwards.

## Unfinished drafts

On Pro and Business, GitHub Issues can also open a separate issue for [unfinished drafts](https://formstep.io/docs/submissions-analytics/partial-submissions/#unfinished-drafts) from the share link, set under **More options** › **Unfinished drafts**. These issues get a `partial-submission` label.

## Limits and behavior

- One new issue per submission. Formstep does not comment on existing issues.

- Only new submissions create issues. Past submissions are not copied in.

- Formstep cuts a title longer than 256 characters and adds an ellipsis.

- An empty title becomes `New submission to <form name>`.

- A file upload answer shows the file name and its download link.

- Answers go into the body as typed. An answer with `@username` notifies that GitHub user, and `#123` links to issue 123.

## When something goes wrong

If you revoke Formstep’s access in GitHub, the integration shows **Connection expired**: click **Reconnect**. If the repository is archived or deleted, edit the integration and pick another repository. For retries and pausing, see [Health and monitoring](https://formstep.io/docs/integrations/health-monitoring/).

## FAQ

**What access does Formstep need?**

Access to create issues in your repositories, to see your account, and to list your organizations’ repositories. You sign in with GitHub; there is no GitHub App to install.

**Can other workspace members see my GitHub connection?**

Yes. GitHub connections belong to the workspace. Any member can use any connected GitHub account in an integration.

**Can I change the repository or milestone after setup?**

Yes. Open Integrations, pick GitHub Issues under **On this form**, change either field, and click Save. Changing the repository resets the milestone, because milestones belong to a repository.

**How do I remove the integration?**

Open Integrations, pick GitHub Issues under **On this form**, and choose **Delete integration** in the ⋯ menu. New submissions stop creating issues at once. This does not revoke Formstep’s access in GitHub: do that on your account’s authorized OAuth Apps page.

## Next steps

[Linear](https://formstep.io/docs/integrations/linear/) — Turn each submission into a Linear issue

[Health and monitoring](https://formstep.io/docs/integrations/health-monitoring/) — Retries, pausing and reconnecting