NOTE: As of May 8th, 2025, we have changed our pricing. Older plans may be mentioned in the video above. You can view our current pricing and plan information on our pricing page at canny.io/pricing.
Overview
Link Canny posts with GitHub issues to keep the two platforms in sync and notify users when a post has been completed!
Link Canny ideas (beta) to Github issues with 2 way sync (NEW)
1) Link Canny posts with GitHub issues
After successfully installing GitHub, you should see a new section in the post sidebar and in the roadmapping/prioritization tool:
Start typing in the name of the issue and Canny will search GitHub and provide suggestions. Select the issue you'd like to link and you're done!
NOTE: Only OPEN GitHub issues can be linked. If the issue is closed, you'll need to reopen it in order to link it to Canny!
You should now be able to click on the link in Canny to view the issue in GitHub. The Canny bot leaves a comment in GitHub with a link back to the Canny post.
Rules for Status Updates
When setting up your GitHub integration, you have the option to set up status change rules. When a rule is created, the status of a Canny issue can be automatically be updated if there are changes to a GitHub issue.
2) Link Canny ideas (beta) to GitHub issues
Accounts with the Ideas (beta) enabled will be able to link Canny ideas to GitHub issues and sync statuses between the two platforms.
Status Mapping
The list of statuses is made by combining the statuses from all GitHub projects in the organization. If you have the same status name on multiple projects, it will only show up once.
Map Github statuses to Canny statuses in your GitHub integration settings:
Linking
To link an issue to an idea:
Click on the ideas tab
Open an idea
On the bottom right of the idea details, you can link a Github issue or view an existing linked issue
Linking rules
One-to-one relationship: Each idea can be linked to exactly one GitHub issue
Single company ownership: If the same GitHub installation is connected to multiple Canny workspaces, only one workspace can link a specific issue to an idea.
Merging ideas: If two Ideas are merged, any GitHub link from the merged idea will be removed.
Issues removed from a project: If a GitHub issue linked to an idea is deleted, the idea–issue link will also be removed.
Important to Know
A GitHub issue must be added to a GitHub project for status syncing to work.
If a linked issue is not part of a GitHub project (legacy), status syncing will be skipped. You can re-enable syncing by adding the issue to a GitHub project.
If multiple issues are linked to a single Idea (legacy), status sync will be skipped.
How to install
To get started, go to your GitHub settings page and click the "Install GitHub" button:
Follow along below:
Step-by-step
From the GitHub settings page click on Install GitHub:
You will then be routed to GitHub where you will be prompted to install our GitHub App.
Select where you want to install Canny. Choose the profile or organization with the GitHub issues you'll be linking to Canny.
You can choose all repositories or select only the repositories that have issues you'd like to link to.
Finally, you will be rerouted back to Canny to complete the installation process. Simply select the company you'd like to integrate with GitHub.
You can then configure what happens to your linked Canny posts when issues are closed in GitHub.
How to Uninstall
If you would like to uninstall the Canny integration from Github, it must be done through the Github application configuration.
Just head to the Installations page in GitHub:
Follow along below:
Step-by-step
1. Start by opening your organization settings from the profile dropdown. Your Organizations > Settings
2. From your settings, navigate through Github Apps > Canny > Configure
3. Finally, you can find the Uninstall button to disconnect Canny from Github.
As always, just reach out if you have any questions. We are here to help! 👍