Skip to main content
Skip table of contents

Connect to Bitbucket Cloud (Bitbucket.org)

You can include information from Bitbucket Cloud repository within your Confluence Data Center pages.

This is handled through the use of an Atlassian API Token that will authenticate the Include Confluence for Data Center app against Bitbucket Cloud.

Warning: This will allow all Confluence users with access to the page to view private repository content the Bitbucket Cloud user has access to.

Generate an API Token

The first step is to generate an App Password in Bitbucket Cloud as follows:

  1. Log into Atlassian with the user you want to use for accessing Bitbucket Cloud

  2. Navigate to your Atlassian Account settings -> Security -> API tokens

  3. Create an API token with scopes

  4. Give the token a name and an expiration date

  5. Select the Bitbucket app

  6. Use the following permissions:

    • read:user:bitbucket

    • read:workspace:bitbucket

    • read:project:bitbucket

    • read:repository:bitbucket

    • read:pullrequest:bitbucket

  7. Create and copy API Token

Configure the Atlassian API Token in Confluence Data Center

The second step is to add the Email & Atlassian API Token information into your Confluence configuration by doing the following in your instance:

  1. Go to Administration → General configuration → Include Bitbucket

  2. Enter the Atlassian email (Must be the Atlassian account login email. Not the Bitbucket username) and Atlassian API Token.

  3. Save the configuration.

Screenshot 2025-08-15 at 12.00.18.png

Add an Atlassian API Token to include public and private Bitbucket Cloud repositories

That is it! You can now include files and information from Bitbucket Cloud repositories.

JavaScript errors detected

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

If this problem persists, please contact our support.