Skip to main content
Skip table of contents

Include tags list ☁️

You can include information on tags from a Bitbucket repository by adding lists of tags in your Confluence page. For each tag you will get the tag name, the message title, the date and the tagger.


Add the macro

You can add the macro either by:

  • typing directly /Bitbucket Tags and ENTER, or

  • using the Insert button from the editor toolbar and then picking the Bitbucket Tags 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 tags. Check out the section below for more information on querying.

Screen recording showing how to add list of tags

Adding list of tags


Query specific sets of tags

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

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

Example:

List all tags whose name contains v1.0

name ~ "v1.0"

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

Filtering a list of tags

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.