GitHub Issues
Create one GitHub issue from each submission, in the repository you pick, with your own title and body.
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 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
@usernamenotifies that GitHub user, and#123links 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.
FAQ
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.
Yes. GitHub connections belong to the workspace. Any member can use any connected GitHub account in an integration.
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.
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.