Include from Bitbucket to Confluence Cloud
Breadcrumbs

Include branches list

You can include information on branches from a Bitbucket repository by adding lists of branches in your Confluence page. For each branch you will get the name and last updated information (date and user of last update).


Add the macro

You can add the macro either by:

  • typing directly /Bitbucket Branches and ENTER, or

  • using the Insert button from the editor toolbar and then picking the Bitbucket Branches macro from the “External Content” category of the macro library.

You will then be prompted to specify the following:

Workspace name

Name of the workspace including the repository

Repository name

name of the repository

Search query (optional)

Query used to filter and sort the list of branches. Check out the section below for more information on querying.

Include Bitbucket - add branches list.gif
Including a list of branches

Query specific sets of branches

As mentioned above you can add a query option to the macro to display a specifically filtered list of branches.

The filtering syntax supported by the Bitbucket API is available in their documentation here: The Bitbucket Cloud REST API

Example:

List all branches whose name contains fix

name ~ "fix"

When adding search queries you can run the query and preview results simply by clicking out of the search query input field.

Include Bitbucket - filtering branches list.png
Filtering a list of branches