Include from Bitbucket to Confluence Cloud
Include from Bitbucket to Confluence Cloud
Breadcrumbs

Changelog

You will find here a recap of all the releases. Please note that for Cloud apps, you will automatically get the latest version.

Download Include Bitbucket for Confluence Cloud on the Atlassian Marketplace

Maintenance

  • Update to third party dependencies

Bug Fixes

  • Fix Markdown strikethrough extension rendering

  • Fix certain relative paths not being resolved in AsciiDoc included files

  • Fix OAuth redirection flow for Confluence Live Pages

Maintenance

  • Update to third party dependencies

  • Documentation link update

  • Authentication flow update to prep for a future Forge requirement

Announcements

  • Continued Progress on Atlassian Forge Migration

    • As part of our ongoing migration of Include from Bitbucket to Confluence to the Atlassian Forge framework, we have now replaced the Get Started page with a new Forge-based module.

    • This update is another step forward in aligning with Atlassian's cloud app development standards. While this change modernizes our app architecture behind the scenes, it does not impact the user experience or functionality at this stage.

    • We’ll continue to roll out updates incrementally to ensure a smooth and transparent transition. For more information on the migration plan and future updates, please refer to our full communication here.

Announcements

  • 🚀 Preparing for Atlassian Forge Migration

    • As part of our efforts to transition Include from Bitbucket to Confluence to the Atlassian Forge framework, our first release focuses on converting to the Forge manifest file. This is a foundational step in the migration process and will not introduce any changes to the app’s functionality or user experience.

    • For a detailed overview of our migration plan, including key timelines and what to expect, please refer to our full communication here.

Maintenance

  • Update to third party dependencies

New Features

  • Added support for !include directives in PlantUML diagrams embedded in AsciiDoc and Markdown files.

    • Users can now include external PlantUML files using the !include directive for PlantUML embedded in Markdown and AsciiDoc files. This will enable better modularization and reuse of diagram components across files in the same repository.

Bug Fixes

  • Fixed an issue with relative images in AsciiDoc files not displaying and resulting in an error.

  • Normalized image paths to include Images in Parent Directory within Markdown Files.

  • Made the Admin Check compatible with Confluence versions 8.x thru 10.x

Announcement

  • Bitbucket Cloud is deprecating app passwords. Starting September 9, 2025, it will no longer be possible to create new app passwords. After June 9, 2026, all existing app passwords will stop working. To ensure uninterrupted access, please switch to using an Atlassian API Token as soon as possible. For more details, see Bitbucket's announcement.

New Features

  • Added support for !include directives in PlantUML diagrams.

    • Users can now include external PlantUML files using the !include directive, enabling better modularization and reuse of diagram components across files in the same repository.

Improvements

  • Enhanced navigation for Table of Contents links in Markdown and AsciiDoc files.

    • Previously, clicking a Table of Contents link would take the user to the source file in Git. Now, the links navigate directly to the corresponding section within the file in Confluence.

  • PlantUML diagrams are now visible when exporting Confluence pages to PDF using the Confluence PDF Exporter.

Maintenance

  • Update to third party dependencies

Maintenance

Maintenance

New Features

  • Supporting PlantUML in Markdown files 🥳

Improvements

  • Improved “Getting Started” Pages 😀

  • Ensure code block are syntax highlighted even when missing a language in the AsciiDoc file

Bug Fixes

  • Fix PDF Export duplicated images due to limitation with Confluence caching mechanism

  • Show error when migration Bitbucket workspace is not found

  • Fix issue with Markdown rendering failure with “illegal group reference“

Maintenance

  • Third party dependency updates

Maintenance

  • Upgrade to HTTP2

    • We are upgrading the app to use HTTP2. The installation of your app will be migrated usually within 48 hours to the new HTTP2 enabled domain.

Maintenance

  • Third party dependency updates

Improvements

  • Added additional languages for syntax highlight support

    • Q

    • reStructured

    • Groovy

    • Protobuf

  • Support direct URLs for meta-data macros under Include Bitbucket for Confluence Cloud to align with the rest of the macros in the Include Family

  • Support PDF Export for meta-data macros like pull requests, etc

  • Add additional ports to authorised list for URL in app configuration

Bug Fixes

  • Ensured AsciiDoc styles are applied for AsciiDoc files.

Maintenance

  • Third party dependency updates

Announcement

  • Lifting limitation on OAuth process when in Incognito mode

    • We lift the limitation we previously had off the back of a security fix that affected the OAuth process when accessing content from private repositories, specifically under the following conditions:

      • Chrome

        • Incognito Mode: Browsers in incognito mode often block third-party cookies, which interferes with the OAuth authentication process.

      • Safari

        • Default Settings: Safari’s default setting, "Prevent Cross-Site Tracking," can prevent the necessary cookies from being shared across sites, disrupting the OAuth flow.

      • Firefox

        • Default Standard Settings: that includes Enhanced Tracking Protection and Total Cookie Protection. These protections interfere with the OAuth process, as it often relies on third-party cookies to manage authentication across different domains.

      • Other Browser Security Settings: If your browser has additional third-party security restrictions enabled (e.g., blocking third-party cookies), these settings can also impact the OAuth process.

    • Users under these conditions should now be able to follow the OAuth process normally.

Security

  • We've addressed a security vulnerability in the OAuth implementation.

    • Limitations:

      • The security fix introduces limitations that affect the OAuth process, specifically under the following conditions:

        • Chrome

          • Incognito Mode: Browsers in incognito mode often block third-party cookies, which interferes with the OAuth authentication process.

        • Safari

          • Default Settings: Safari’s default setting, "Prevent Cross-Site Tracking," can prevent the necessary cookies from being shared across sites, disrupting the OAuth flow.

        • Firefox

          • Default Standard Settings: that includes Enhanced Tracking Protection and Total Cookie Protection. These protections interfere with the OAuth process, as it often relies on third-party cookies to manage authentication across different domains.

        • Other Browser Security Settings: If your browser has additional third-party security restrictions enabled (e.g., blocking third-party cookies), these settings can also impact the OAuth process.

      • Refer to the FAQ for more details.

      • Action Required:

        • Re-authentication: All users will be required to re-authenticate with GitLab when using our app to render content from private GitLab repositories in Confluence.

        • Access Token Revocation: GitLab access tokens issued before this update have been revoked. Users are asked to configure the tokens again in the app configuration under the Confluence Admin settings.

    • Recommendations:

      • Review your account activity for any suspicious behavior and report it to our support team.

New Features

  • Confluence Cloud Dark theme support 🕶️

Improvements

  • Support inline HTML Image tags in Markdown

    • Example: Here is an inline image: <img src="image.jpeg" width="100" alt="Alt text"/>

  • Add Bitbucket branch macro default sort (descending date)

Bug Fixes

  • CSV Table UI rendering

  • Files with spaces rendered

  • Handle Markdown link path url spaces in Markdown

  • File URL auto-converting to directory macro

Improvements

  • Add branch meta data to File Macro UI

  • Improve code block rendering in Markdown files

Maintenance

  • Third party dependency updates

New Features

  • Support Rendering Mermaid files (.mmd & .mermaid)

    • Now supporting Mermaid file as well as Mermaid in Markdown.✨

Improvements

  • Improved database encryption

  • Improved UI for all macros

Maintenance

  • Update to third party dependencies

Bug Fixes

  • Collapsible option should defaulted to true for file and directory macro

Maintenance

  • Third party library updates

Improvements

  • Show Title when rendering AsciiDoc files

Maintenance

  • Third party library updates

Bug Fixes

  • Bug fix affecting Admins in non-default groups not being able to access settings. In newer Confluence sites, the roles names include the site name. Bugfix uses a more appropriate API to check if the user is an Administrator.

New Features

  • Collapsible File Option

    • Including files and directories has gotten easier with the collapsible file option. The option can be activated in the File & Directory macro configuration menu which will allow you to collapse and expand the files included.

Improvements

  • Supporting limited HTML in Markdown

    • Support for additional limited HTML within Markdown files has been added which will improve the rendering of HTML tables and certain HTML tags like <details> and <summary> .

  • Improved styling of Markdown tables

    • We have improved the styling of tables with Markdown to help you distinguish table content at a glance.

Improvements

  • Support for rendering PlantUML files & blocks in AsciiDoc

Bug Fixes

  • Fix issue where images with spaces or special characters in their name couldn’t be included in Markdown

New Features

  • Support for Shared Access Token Authentication

    • By default Include Bitbucket for Confluence uses personal OAuth to access private repositories. This ensures that each Confluence user can only access private repositories that they have access to, but requires a that each user has a Bitbucket account.

    • You can change the authentication to a shared access token for all Confluence user. This allows all users to see included files without any Bitbucket account.

New Features

  • Mermaid Support

    • Mermaid in Markdown now supported & rendered. ✨

Security

  • Enhanced privacy and security measures taken to delete any data stored when app is un-installed.

New Features

  • PlantUML Support

    • Included PlantUML files are now supported and rendered. ✨

Improvements

  • Support Copy and Pasting Directory Paths

  • Support AsciiDoctor default CSS

  • Improve Markdown anchor links redirection

Maintenance

  • We released some updates related to normal maintenance and security.

Improvements

  • Adjust timeout so each included Asciidoc file has a 5 second fetch timeout to allow using Asciidoc files with many includes.

  • Increase file max limit of files from 20 to 50 rendered including for the Directory Macro

New Features

  • Support for Including Directories

    • You can now include all files in a directory at once with the new Bitbucket Directory macro. Include your configuration files, REST API docs and other documentation directories from GitLab to share with your team.

    • If you add new files or delete existing ones in a directory, the changes will be automatically reflected in the Confluence page.

Improvements

Improvements

  • Improved configuration panel layout.

  • Updated the Getting Started links.

  • Updated to the latest Scribe OAuth library.

Improvements

  • Improved Breadcrumbs in Macros

    • We improved the breadcrumbs for the pull request, tags, issues, commits and branches macros. It now also shows the filter applied and says what content is shown

Security

  • Disallowing using URLs which are not GitLab urls. This prevents including unexpected resources and having unexpected behavior if non-GitLab resources are included

New Features

  • Basic Support for CSV

    • CSV files are now rendered as a proper table.

Improvements

  • Improved Support for Various Languages

    • Added Syntax Highlighting for D, HCL, Objective-C, Swift

    • Improved Auto-Detection for Dockerfiles, HTML, Swift, Objective-C, HCL, Kotlin, D, Go

New Features

  • Static IP Support to connect Confluence Cloud with Bitbucket DC

    • Do you want to include files or Git metadata from your Bitbucket DC instance that is behind a firewall? You can now use a static IP for traffic from Include Bitbucket for Confluence Cloud, so that you can whitelist the app. See the documentation.

Improvements

  • Update in app links to new and improved documentation space

  • Add more file URL segment matchers in order to use copy and paste to render files

Bug Fixes

  • Allow relative links in Markdown to work properly and take the user to the url

Bug Fixes

  • Fixed bug when using the migrated file macro

Maintenance

  • Improved Security by upgrading to the latest version of some libraries

New Features

  • Supporting PDF/Word Export for Files

    • You can now export your files using the GitHub File Macro to PDF or Word.

Bug Fixes

  • Fixed the assignee name not displaying for the Bitbucket Issue Macro

Maintenance

  • Improved Security by upgrading to the latest version of some libraries

Bug Fixes

  • Eliminate timeouts experienced by some users with Bitbucket macros using large repositories

  • Add text to configuration to clarify that line number option is not available for Markdown & AsciiDoc files when using the File Macro

Maintenance

  • Improved Security by upgrading to the latest version of some libraries

New Features

  • Introducing a hide header option in the file macro configuration form

Improvements

  • Autodetect XSL file formats and render as XML

  • Add contrasting gray background color to source code in markdown so it is easier to read

Bug Fixes

  • Allow plain links to be rendered in Markdown

  • Show consistent error messages for Bitbucket macros when user tries to access private repo content 

Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

Improvements

  • Large image files included in the file macro are now scaled properly

Bug Fixes

  • Fixed issue with Branch macro when a branch is created by a non-Bitbucket user.

Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

  • Improved Security by adding stricter Content Security Policies (CSP).

Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

Improvements

  • Simplify Bitbucket login handling to provide a Single OAuth token per user, instead of per User + Workspace

Improvements

  • Automatically upgrade a Bitbucket DC URL to https if http is entered by mistake after configuration

Bug Fixes

  • Offer explicit logout in the macro if user is logged in into multiple Bitbucket accounts

Maintenance

  • Updated dependencies

Bug Fixes

  • OAuth Handling

Bug Fixes

  • Improved File Download Limits

  • Auto detect JSON file syntax highlighting

  • Accommodate extra spaces in macro parameters

Maintenance

  • Updated dependencies

Bug Fixes

  • Enforced a max file size limit for images

  • More specific Bitbucket URL matching

Maintenance

  • Updated dependencies

Maintenance

  • Fixed a Cross Site Scripting Vulnerability for Markdown and Asciidoc, where links could contain Javascript.  

Maintenance

  • Fixed vulnerable dependencies

New Features

  • Automatic Syntax Highlighting for Gherkin Files

    • Gherkin syntax highlighting is now applied and rendered automatically.

Bug Fixes

  • Allow Word file types like (e.g. .docx) to be downloaded instead of rendering unreadable characters

Maintenance

  • Address vulnerable dependencies

Maintenance

  • Fixed vulnerable dependencies

New Features

  • Automatic Syntax Highlighting

    • The type of the included files is now detected and the appropriate syntax highlighting is applied,

    • Markdown and AsciiDoc files are rendered automatically.

    • When you want the raw text, select the ‘Plain Text’ syntax highlighting.

  • Support including Tags from Bitbucket Cloud

    • You can now include Bitbucket tags from Bitbucket Cloud and from private and public repos. You asked for the ability add a tag list and have the ability to filter the tags and we have delivered.

Improvements

  • Updated the commit list macro layout so it is easier to read at a glance

New Features

  • Support including Commits from Bitbucket Cloud

    • You can now include commits from Bitbucket Cloud and from private and public repos. Commits are particularly useful for organisations that do not use pull requests as often.

  • Support including Branches from Bitbucket Cloud

    • Branches are now available from Bitbucket Cloud and from private and public repos. Branches are helpful for seeing the repository state in terms of deviating code and parallel development.

Improvements

  • The iframe panel in edit and preview mode now resizes automatically to fit the content for the pull requests, issues and now commits macro.

Improvements

  • Typing /include should list all Include for Bitbucket macros.

  • Improved performance of loading the macro: More sources are now cached by the browser and do not need to be downloaded for every macro instance.

Maintenance

  • Fixed a Cross-Site Scripting (XSS) vulnerability in the Include Issues and Include Pull Request macros.

Bug Fixes

  • Windows users: extra horizontal padding was appearing below new Include macros, resulting in significant whitespace between the macro and the next line. The padding has been removed, so all operating systems should see the page comparably.

  • Page rescaling events could result in macros “leaking” height, and the macro iframe growing with each event. This has been resolved.

Improvements

  • Including images is now support. The image is show inline instead of gibberish.

  • Including binaries now shows a download link to the binary.

Bug Fixes

  • If the file in a private repository was not found, the app crashed. Now it shows the proper error message.

Improvements

  • Performance monitoring has been added, to detect issues with the app earlier.

Improvements

  • Large image files included in the file macro are now scaled properly

Bug Fixes

  • Fixed issue with Branch macro when a branch is created by a non-Bitbucket user.

Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

Improvements

  • A more helpful error is shown when the authentication to Bitbucket Data Center isn’t working

Bug Fixes

  • Fixed including file URL’s with spaces in the path.

Improvements

  • Download Time Limit

    • We added a 2 seconds limit for the file download. This prevents showing empty spaces when the file download is very slow or never completes.

  • Improved Wording in Title and Help Text

    • We clarified titles and descriptions to make it more clear what applies to Bitbucket Cloud and what to Bitbucket server. We also fixed the documentation link in the admin panel.

New Features

  • Support file inclusions from Bitbucket Data Center

    • We strive to make the user experience better with each release. This time, you are finally able to use the “Bitbucket file” macro together with Bitbucket Data Center. We hope this feature makes the integration between Confluence Cloud and Bitbucket Data Center easier for you.

  • Support for Migrating From Bitbucket Server and Data Center

    • It’s now possible to migrate pages with included Bitbucket files from Bitbucket Data Center to the cloud and keep the macro content. It only applies to Bitbucket files. Other macros are compatible between the Data Center and the Cloud edition. Read the migration documentation on for the details.

Improvements

  • AsciiDoc files will render relatively referenced images from public Bitbucket

  • File inclusions inside AsciiDoc files are rendered correctly

  • Syntax highlighting of included source code supports more languages (e.g. Go, Rust, Scala, Kotlin, Gherkin and Clojure)

New Features

  • Improving usage of macro with efficient URL copy and paste functionality

    • We strive to make the user experience better with each release and we think we have delivered this time around. We have made it easier to include a Bitbucket file URL that will be automatically converted and displayed by the macro. This will make it even faster to get your file rendered in Confluence so you can move on to more important work.

  • Now supporting Ascii Docs

    • We have finally delivered the ability to render Ascii Doc files in the cloud version of this app. When you include Ascii Doc files, the files now are rendered instead of showing the raw text file. We hope you enjoy this valuable new feature.

  • Making it easier to “Get Started” with Include Bitbucket

    • We want to make sure that installing Include Bitbucket is as seamless as possible so we have added a “Get Started” menu option which includes a link to helpful information including documentation, key features and set up steps. It’s never been easier to get started with Include Bitbucket!

Improvements

  • Relatively referenced images on Bitbucket are now rendered in Markdown

New Features

  • The Java Syntax Highlighter was added.

  • Included the Bitbucket files in the file path as well as the related hyperlink for easy reference.

Bug Fixes

  • The amount of white space below rendered Markdown was reduced.

  • Removed unnecessary HTTP requests for syntax highlighting.

  • Improved error message when authentication to private Bitbucket repositories fails.

Bug Fixes

  • Limit the file size to 1MByte. If a file is larger than 1MByte, only the first 1MByte will be included.
    Previously large files could crash the app.

Bug Fixes

  • Fixed issues with non ASCII files. Text files are now assume to be UTF-8 and read as such when included.

  • Improved Security by upgrading to the latest version of the Atlassian Connect libraries.

Bug Fixes

  • Fixed an issue submitted via Bugcrowd. On Confluence Cloud sites with anonymous access enabled, an anomymous JWT token could be used to add or remove Bitbucket Cloud OAuth consumers to that site. It was not possible to extract existing OAuth client ids and secrets.