Include commits list ☁️

You can include information on commits from a Bitbucket repository by adding lists of commits in your Confluence page. For each commit you will get the commit id, message, date of creation and author.

Add the macro

You can add the macro either by:

typing directly /Bitbucket Commits and ENTER, or
using the Insert button from the editor toolbar and then picking the Bitbucket Commits 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 commits. Check out the section below for more information on querying.

Screen recording showing how to add a list of commits from Bitbucket — Add a list of commits

Query specific sets of tags

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

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

Example:

List all commits that concern the master branch and display only the first 5 of them

include=master&pagelen=5

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