Include issues list ☁️

You can include information on issues from a Bitbucket repository by adding lists of issues in your Confluence page. For each issue you will get the title, status, assignee, created and last updated information.

Add the macro

You can add the macro either by:

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

Screencast showing how to add issues list from Bitbucket — Including an issue list in your page

Query specific sets of issues

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

The filtering syntax supported by the Bitbucket API is available in their documentation here: https://developer.atlassian.com/cloud/bitbucket/rest/intro/#filtering .

Examples:

List all new issues	`state="new"`
List all new issues that have not been assigned yet.	`state="new" AND assignee=NULL`

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