Using the GitHub Power-Up

If you use GitHub, you can also use Trello's GitHub Power-Up to attach pull requests, issues, and commits 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.

screenshot_GitHub

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."

screenshot_GitHubAuthorize

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

screenshot_GitHubAuthorizaBanner

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.

screenshot_AuthorizeGitHubAccount

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.

screenshot_GitHubEnterpriseEndpoing

Note: While we do support GitHub Enterprise, we only support instances hosted on https. We do not support GitHub Enterprise over http.

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.

screenshot_CardPowerUpGitHub

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.

screenshot_CardWithGitHub

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. 

screenshot_GitHubSettings

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.

screenshot_GitHubEdit

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.

Additional Help