Trello boards in Bitbucket

 

A Trello board is a list of lists, filled with cards, used by you and your team. It’s a lot more than that, though. Trello has everything you need to organize projects of any size.
Take the Trello tour...

Get going with Trello

To get going with Trello boards in Bitbucket Cloud, you only need to:

Get a Trello account

If you don't already have a Trello account, go to https://trello.com/signup to create one.

(We're assuming you already have a Bitbucket Cloud account.)

 

Enable boards in Bitbucket

If you're a Bitbucket repo admin, enable Trello boards for the repo by clicking Boards in the left-hand nav panel, then Enable boards for Bitbucket.

Now you can either create a new board (see below), or add a board you've already created in Trello.

(You can disable boards for a repo by going to SettingsSettings (under 'Trello') and toggling Enable boards.)

 

Set team access to boards

To set access to the boards for a repo, go to Settings for the repo, then Settings (under 'Trello'). Self-invite permissions correspond to the access permissions on the repo, so for example, people with WRITE access to the repo will only see the board if the board permissions are set to WRITE or lower:

 

Create your first board

You can create your first Trello board directly from a Bitbucket Cloud repo (once boards have been enabled for the repo).

  1. In a Bitbucket repo, click Boards in the left-hand navigation panel, then Create a new board
  2. Give the new board a name, and choose the team (if any) you want to collaborate with:

Now you can create cards and lists in the board, without leaving Bitbucket. See the Trello Getting Started guide for more information.

To add extra boards to a repo, create the board in Trello, then link it to the repo.

 

See your repo information on Trello cards

When you add a Trello board to a Bitbucket Cloud repo, your team can see repo information right on the cards in a board:

  • Branch, commit, and pull request updates.
  • The latest status for builds and pull requests.

You can also create a branch directly from a card.

Attach repo information to a card like this:

  1. Click on the front of a card and then the Bitbucket Power-Up.
  2. Choose an action:

When you attach a pull request or branch to a card, you'll see a green or red icon indicating the latest build status of that pull request or branch.

 

Troubleshooting

I just linked a board but the Power-Up isn't working

Click to see details...
Symptom

When you connect to an existing Trello board you can see the board in Bitbucket, but you don't see any repo information on the cards.

 

Explanation When you link Bitbucket to a board, Bitbucket attempts to install the Bitbucket Cloud Power-Up on the board. This will fail if the board already has the maximum number of allowed Power-Ups.
Actions you can take
  • You can upgrade your Trello account so you can have more Power-Ups per board.
  • You can remove an existing Power-Up from the board so that the Bitbucket Cloud Power-Up can be added.

I try to join a board in Bitbucket but the link doesn't work

Click to see details...
Symptoms

When you try to join a board in Bitbucket you see a message like:

  • "Whoops! The invitation link for this board isn't valid anymore…"
  • "Unfortunately, this invitation link has been deactivated. Perhaps you could ask for a new one?"
Explanation Bitbucket maintains self-invite links that allow users to add themselves to a board, if they have sufficient repo permissions. If a board user unlinks the board, then later reconnects the board, the old self-invite links will no longer work.
Actions you can take

If you're a repo admin:

  1. Go to Settings for the repo, then the Trello Settings page.
  2. Unlink the board for which the link has gone stale.
  3. Re-link the board and set the self-invite permissions.
If you're not a repo admin, ask a repo admin to do the above steps.

I'm not seeing the boards I expect in Bitbucket

Click to see details...
Symptoms
  • You're not seeing the boards you expect in Bitbucket.
  • You're seeing boards in Bitbucket that shouldn't be visible to the Trello account you're logged in with, for example in the Select board list.
Explanation

Bitbucket first authenticates with Trello using the Trello account that you're currently logged into Trello with.

If you log out of Trello, then log back in later using a different Trello account, Bitbucket will still authenticate using the first Trello account, so you'll see the boards associated with that account.

Actions you can take

If you're a repo admin you can:

  1. Go to Settings for the repo, then the Trello Settings page.
  2. Click Disconnect.

This will revoke your current Trello authorization and require Bitbucket to reauthorize with Trello when you next try to view a board in Bitbucket.

If you're not a repo admin:

  1. Log out of Trello and log back in using the Trello account you originally used to connect with Bitbucket.
  2. Go to your Trello settings and find the 'Bitbucket' entry under 'Applications'.
  3. Click Revoke to remove the connection.
  4. Log out of Trello and log back in using the second Trello account.

You'll need to reauthorize when you next try to view a board in Bitbucket.

I can't see my repo integrations in a board in Bitbucket

Click to see details...
Symptom

You're not seeing information about commits, branches, pull requests and builds for a repo as you expect.

Explanation

The Bitbucket Cloud Power-Up waits until you interact with it for the first time before attempting to authenticate and sync with Trello.

If you've never interacted with the Power-Up (such as by adding a commit to a card), then the authentication won't have happened, and links to the repo won't have been created. 

Actions you can take

You can link the board to a new repository manually, which will trigger the board to sync with Bitbucket:

  1. Go to the board menu and click Power-Ups.
  2. Find the Bitbucket Power-Up and click the 'cog' button.
  3. Click Edit Power-Up Settings.
  4. Click Add Repo and enter a repo name.

You can manually resync the board with Bitbucket:

  1. Go to the board menu and click Power-Ups.
  2. Find the Bitbucket Power-Up and click the 'cog' button.
  3. Click Edit Power-Up Settings.
  4. Click Sync with Bitbucket.
Last modified on Nov 15, 2017

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.