Use the GitHub Power-Up

Use Trello's GitHub Power-Up to attach pull requests, issues, and commits from Github directly to your Trello cards.

Enabling the Power-Up

To enable the Power-Up, open the board menu on the right side of the page, select the Power-Ups menu option, and then click the "Enable" button next to the GitHub Power-Up.

Authenticating with GitHub

After enabling the Power-Up, click on the gear symbol and then click on "Authorize Account" to give your GitHub account access to Trello. Then click "Link Your GitHub Account."

In the new window, click "Authorize application" to allow Trello to access your GitHub account.

Authenticating GitHub Enterprise

If you're using GitHub Enterprise, the steps to authenticate will look a little different. First, when authorizing, click the link for GitHub Enterprise, rather than the green button, as seen in the screenshot below.

Next, a window will pop up asking for the API endpoint for your GitHub Enterprise instance. This should be the URL where your GitHub instance is hosted (e.g., https://github.yourcompany.com/) with /api/v3/ added to the end of that URL. If you're not sure what your API endpoint is, check with an administrator of your GitHub Enterprise instance.

Using the Power-Up

With the Power-Up active, you can access it from the Power-Ups button on the back of any Trello card on that board. Here, you can attach a Branch, Commit, Issue, or Pull Request to your cards.

Attached items will also show relevant additional information from GitHub and give you direct links to the content. Attaching a Pull Request, for example, will bring in the name of the Pull Request, whether it has passed any checks, any labels that may be added to the Pull Request, who opened the Pull Request, whether it was merged, the name of the person assigned, and the number of comments.

Disabling automatic comments in GitHub

By default, linking GitHub content to a Trello card using the Power-Up will automatically leave a comment linking back to the Trello card. You can disable this setting in your GitHub Power-Ups settings.

Click on the GitHub Power-Up in your Board Menu and choose 'Edit Power-Ups Settings', then uncheck the option to add a comment. 

Disabling the Power-Up

To disable the authorization with your GitHub account, open the Power-Ups menu on the right side of the board. Then, click the gear icon next to the GitHub Power-UP and select "Remove Personal Settings". From there, select the option to clear data.

You can disable the Power-Up for the board by opening the Power-Ups menu, clicking on the gear next to GitHub, and selecting the Disable button. Disabling the Power-Up will not cause any data loss. It will change the formatting of the links in the card to be the same as any other attached links.

GitHub Power-Up organization repos not showing

If you are unable to find your organization’s repos when using the GitHub Power-Up within Trello, you can try these troubleshooting steps.

Grant access to a GitHub organization

1. Go to the Trello GitHub Integration settings at https://github.com/settings/connections/applications/9166c2b763b5af41364e

2. Look for the section titled Organization access

3. Look for the new organization that you want to grant the GitHub Power-Up access to. There should be a button next to it that says "Grant" (or "Request"). Click this button to grant or request access to the new org for the GitHub Power-Up.

4. Then on your Trello account, you may need to click Remove personal settings under the GitHub Power-Up to re-sync your GitHub account to Trello. Once you authorize your account again, you should see the organization.

Remove the authorization for the GitHub Power-Up from Trello and GitHub

To remove authorization in Trello:

1. Open the board menu

2. Select Power-Ups

3. Select GitHub, then Remove personal settings

To remove it from GitHub:

1. Go to GitHub and click your profile icon

2. Select Settings then Applications

3. Select Revoke next to Trello GitHub Integration will remove the Trello GitHub Power-Up's access.

At this point, you can go back to Trello and try to use the GitHub button to attach something. This will ask you to re-authenticate with GitHub.

Make sure that the organization has a green checkmark next to it. If it doesn't, you may need to reach out to your organization's admins to change its settings. It may be that the organization has third-party application restrictions on it.

See https://help.github.com/articles/about-third-party-application-restrictions/ for more information.

Why does the GitHub Power-Up require read-write access?

Our GitHub Power-Up requests the minimum viable scope necessary for it to work. We need those two scopes so that we can list all available repos (both public and private), as well as PRs, branches, issues, and commits in those repos. 

The only instance in which the GitHub Power-Up ever writes back into GitHub is when attaching a PR, issue, or commit to a card with the GitHub button. Trello will make a comment on the attached item on GitHub with a link to the Trello card. This feature can be disabled in the GitHub Power-Up's settings menu (in which case we write nothing back to GitHub).