GitHub Plugin

Use the GitHub Plugin to create new GitHub issues from form results. Turn submissions into actionable issues without manually copying information from your form into GitHub.

# Set Up the Plugin

Open the Plugins page for your form, select GitHub, and click Connect to GitHub:

Click Authorize funforms to grant the plugin access through the GitHub authorization window:

🚨 Changing repository access: If you’ve already authorized the GitHub Plugin and want to give it access to another repository or organization, you’ll need to revoke the existing authorization first. Visit your Authorized OAuth Apps in GitHub, find Fun Forms, and click Revoke. You can then connect the plugin again and select the additional repositories you want to use. This is due to limitations with GitHub OAuth.

Once GitHub is authorized, select the Repository where you want to create new issues, then click Save:

Once connected, you’ll see a link to your selected GitHub Repository.

# Customize the Issue Title

By default, the GitHub Plugin uses your form name as the title for each new issue. You can customize the Issue Title using the Field Mapper and data from your form results.

# Issue Title

Let’s add a Bug Name field to our form, then configure the GitHub Plugin to use its value as the Issue Title:

Go to Plugins > GitHub and find the Field Mapper.

Select the Bug Name field, then enter issue_title in the Map To column. This tells the GitHub Plugin to use the value entered in Bug Name as the title of the GitHub issue:

Now enter a value in the Bug Name field when submitting the form:

When the form is submitted, the GitHub issue is created using that value as its title:

The rest of the form response is included in the GitHub issue description:

🏆 Hint: The GitHub account used to authorize the plugin is the account that creates the issues in the repository.

That’s it! If you need any help, contact us anytime.