Include from Bitbucket to Confluence
Include from Bitbucket to Confluence
Breadcrumbs

Changelog

Version 4.x

4.1.5:

Maintenance

  • Update to third party dependencies

Bug Fixes

  • Fix Markdown strikethrough extension rendering

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

4.1.4:

Bug Fixes

  • Fixed an issue preventing links with the lines= parameter from Bitbucket Cloud from being pasted correctly.

4.1.3:

Bug Fixes

  • Fixed an issue causing the Pull Request and Commit macros to fail to render on Confluence 10.

  • Resolved a problem where a 'null' value appeared in the repository field when switching projects in the macro dialog.

  • Fixed an issue preventing links with the lines= parameter from Bitbucket Data Center from being pasted correctly. Issue affecting files with the lines= parameter from Bitbucket Cloud will be addressed at a later time.

  • Addressed a bug where links to personal repositories in Bitbucket Data Center were not working as expected

4.1.2:

Maintenance

  • Update to third party dependencies

41.1:

New Features
Improvements

  • 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.

  • Provided a way to admins to provide an Atlassian API Token instead of Password for Bitbucket configuration.

Bug Fixes

  • Fixed issue causing certain relative image paths in Markdown to render incorrectly

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

  • Fix size issue with PlantUML diagrams showing very small during PDF export

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

Maintenance

  • Update to third party dependencies

4.1.0:

Announcements

  • Bitbucket 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. For more details, see Bitbucket's announcement.

  • 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.

Bug Fixes

  • Ensure the macro is visible during auto-conversion when no configuration is set.

Maintenance

  • Update to third party dependencies

4.0.0:

⚠️ Major Changes

  • As part of this release, we’ve made changes to align with Atlassian’s End of Life (EOL) Policy:

    • Only supporting Confluence 8.5.3 or newer
      Confluence 8.4 will be end of life in July 7th 2025. In order to focus to support Confluence 10, we decided to only support Confluence 8.5.3 or newer.

  • Supporting Upcoming Confluence 10

    • Confluence 10 is on the horizon. We adopted the application also run in Confluence 10. All the features keep working as before in Confluence 10.

Maintenance

  • Update PlantUML

    • We updated to the latest PlantUML version, so support its latest features.

  • Updating Support Links

Version 3.x

3.0.3:

Bug Fixes

  • Fix issue with Mermaid diagrams not rendering in files

Maintenance

  • Update to third party dependencies

3.0.2:

Improvements

  • Support PlantUML in Markdown

  • Support rendering of Markdown block elements

Bug Fixes

  • Fix syntax highlighting when file is on same page a Confluence Code Block macro

  • Display block img tags in Markdown

  • Fix AsciiDoc code block with syntax highlighted when missing language

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

3.0.1:

Bug Fixes

  • Fix compatibility issue with Source Code Editor

3.0.0:

⚠️ Major Changes

  • As part of this release, we’ve made changes to align with Atlassian’s End of Life (EOL) Policy:

    • Dropped Support for Confluence 7
      Confluence 7 reached its end of life as per Atlassian’s support schedule. By discontinuing support, we can focus on delivering the best experience for users on Confluence 8.1.0 + and 9 +, ensuring compatibility, performance, and security.

    • Removed Support for Java 8
      Java 8 is no longer supported, allowing us to take advantage of new features and improvements in modern Java versions, providing a better and more secure foundation moving forward.

Version 2.x

2.8.3:

Bug Fixes

  • Fixed syntax highlight for HTML/XML

  • Removed syntax highlight for AppleScript, ActionScript, ColdFusion, Diffs, Erlang, JavaFx and Perl. Let us know if you require any of these languages in your macros.

  • Fix handling of Bitbucket Cloud URLs from a branch

2.8.3:

Improvements

  • Syntax Highlighting Improvements

    • Including added additional languages for syntax highlight support

      • Q

      • reStructured

      • Gherkin

      • Protobuf

    • Support AsciiDoc styles

Bug Fixes

  • Fix some issues with handling & rendering of error / info messages

2.8.2:

Maintenance

  • Fixed cross site scripting vulnerability

2.8.1:

Bug Fixes

  • Handle multiple Markdown files with Mermaid included in the same Confluence page correctly.

Maintenance

  • Third party dependency updates

2.8.0:

New Features

  • With Confluence version 9.0.0 only - Support for Dark Theme 🕶️ 

Improvements

  • Sort branches in Branch Macro by descending date

  • Support inline HTML Image tags in Markdown

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

Bug Fixes

  • Fill project/workspace with value when copy and pasting URL in Confluence

  • Handle Markdown link path url spaces in Markdown

Maintenance

  • Future version Confluence 9.0.0 preparation

2.7.2:

Improvements

  • Add branch meta data to File Macro UI

Bug Fixes

  • Eliminate error with reStructured file syntax highlighting

  • Show error message to users with admin permissions when accessing settings only authorized for system admins

  • Fix placement of copy button in source code file macro when long lines are present

Maintenance

  • Preparation for a future version of Confluence (9)

  • Third party dependency updates

2.7.1:

Improvements

  • Macro UI improvements

Maintenance

  • Third party dependency updates

2.7.0:

New Features

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

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

Bug Fixes

  • Fix bug causing image files with spaces to crash macro

2.6.7:

Maintenance

  • Maintenance - prep for Confluence 8.8 compatibility

2.6.6:

Improvements

  • Show the title of an AsciiDoc document

Maintenance

  • Stricter Content-Security headers for certain URLs.

2.6.5:

Maintenance

  • Security updates to prevent cross side scripting injections

2.6.4:

Maintenance

  • Security updates to prevent cross side scripting injections

2.6.3:

Bug Fixes

  • Bug Fixes for Mermaid support and Table styling

2.6.2:

Improvements

  • Improved Markdown table styling

  • Updates to HTML Support in Markdown including Table Styling

Bug Fixes

  • Collapsible File Bug Fix

2.6.1:

Improvements

  • Improve the Markdown links handling to be more consistent with Bitbucket

  • Supporting rendering PlanUML within AsciiDoc

Bug Fixes

  • Fix bug where images in Markdown with spaces or non-ascii characters in their path name couldn’t be included.

2.6.0:

New Features

  • Mermaid Support

    • Mermaid in Markdown now supported & rendered. ✨

2.5.1:

Bug Fixes

  • Fix Bug where Plain Text files are interpreted as PlantUML diagrams

2.5.0:

New Features

  • PlantUML Support

    • Included PlantUML files are now supported and rendered. ✨

Maintenance

  • Improved cross-site request forgery (XSRF) protection.

2.4.4:

Maintenance

  • Maintenance and Security Updates

2.4.3:

Maintenance

  • Security bugfix for Cross-Site-Scripting (XSS) vulnerability. An attacker could craft repository and file names, which could be used as cross site attack in the macro editor.

2.4.2:

Maintenance

  • Security bugfix for Cross-Site-Scripting (XSS) vulnerability. An attacker could craft repository and file names, which could be used as cross site attack in the macro editor.

2.4.1:

Improvements

  • UX Improvements to the configuration page

Bug Fixes

  • Bug Fix to auto preview Bitbucket DC files in the editor when copy and pasting

2.4.0:

Announcements
New Features

  • CSV Support

    • Included CSV files are now rendered as a proper table

Maintenance

  • Improved cross-site request forgery (XSRF) protection.

2.3.5:

Bug Fixes

  • License enforcement fix for expired licenses

Maintenance

  • Update documentation links and site for a better user experience

  • Protect app against XSS edge cases

2.3.4:

Improvements

  • added i18n translation keys so the app text can be translated by users overriding the language packs with their own translations.

2.3.3:

Bug Fixes

  • fixed a production issue that caused Asciidoc files to no longer render. This bug was introduced with version 2.3.1.

2.3.2:

Bug Fixes

  • we fixed a production issue that users may have noticed if using an older version of Confluence Data Center/ Server (pre 8.0) and either version 2.3.0 or 2.3.1 of Include Bitbucket for Confluence Data Center/ Server. The issue was an app conflict that caused endless loading or a blank screen while using the editor. The root cause of the issue was a missing web resource that was added back in with version 2.3.2. We ask users under these version constellations to update to the latest version as soon as feasible.

Maintenance

  • updated dependencies

2.3.1:

Bug Fixes

  • included Maintenance & Security Updates

2.3.0:

Announcements
Improvements

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

  • Allow auto preview after completing the required information in the macro

  • Find Include macros with "include" vs. only "bitbucket"

Bug Fixes

  • Allow overwriting of binary file for rendering. Previously, if we detected files as binary like for example XSL files, then the user could get stuck because they couldn't see the content despite the files being actual XML. We now allow the user to explicitly select a programming language, then render it as such, even if detected as binary.

    • Note: If you ever edited a macro for a binary file and set it to 'Plain Text', we will now render it as such after this release. If you want to change this then the user has to manually unselect the Plain Text option.

Maintenance

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

2.2.5:

  • Fixed: Render images embedded in markdown file from a directory with spaces

2.2.4:

Improvements

  • Improved in app guide for connecting to Bitbucket Cloud

Bug Fixes

  • Shorted the image cache time to 1 minute. Ensures updated images on Bitbucket are shown in Confluence

  • Fixed: Applying file limit in the Ant Pattern macro

2.2.3:

Bug Fixes

  • Fixed a bug where the Bitbucket Login HTML was shown instead of a dialog to authenticate via OAuth

Maintenance

  • Updated vulnerable libraries

2.2.2:

Bug Fixes

  • Fixed bug where error were not displayed in the macro editor

  • Show an error message if a Asciidoc ‘include::' includes a too large file

  • Bitbucket Application Link to Bitbucket Connection

2.2.1:

Bug Fixes

  • Fixed bug with ignored max. number of items for Bitbucket Cloud application link for Branches, Pull Requests and Commits Macros

  • Enforced a max file size limit

  • Allow Word (Office) documents to be downloaded instead of showing garbled text

  • Render Ascii files that include inline images with a title attribute instead of an error message

2.2.0:

New Features

  • List your Git Tags from Bitbucket on any Confluence page

    • Get and share an overview of your latest releases by showing a list of your release tags on your projects Confluence page.

Improvements

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

  • Allow auto preview after completing the required information in the macro

  • Find Include macros with "include" vs. only "bitbucket"

Bug Fixes

  • Fix branch macro behaviour not displaying results when using the filter “maximum number of last updated branches to show”. (DC/Server application link only) With this release, the user should be able to use the filter to render the branch list.

2.1.3:

Bug Fixes

  • Fixed a issue where images are not shown, when Confluence runs on Windows

2.1.2:

Bug Fixes

  • Fixed an issue, where application links with different display- and internal- URL did not work.

  • Fixed an issue where the Include Bitbucket admin panel got mixed with other apps installed on Confluence.

  • Fixed the download links for binaries on Bitbucket Cloud.

  • Asciidoc’s link:, :relfileprefix and :imagesdir are now handled correctly

2.1.1:

Bug Fixes

  • Fixed regression with ignored max. number of items to show parameter in branches and commits macros

2.1.0:

New Features

  • Including files from Bitbucket Cloud is now supported. After that you can include Bitbucket Cloud files, pull requests, Git branches etc. Only Bitbucket files via Ant pattern is no supported for Bitbucket Cloud.

Improvements

  • Referenced files in Asciidoc and Markdown are reliably shown, even when the Confluence user isn’t logged into Bitbucket.

  • It’s possible to select a single line of a file.

  • *.sh shell files are detected as text instead of binaries.

  • Pasting Bitbucket file URLs with a specific line selected does work.

2.0.4:

Maintenance

  • Update to third party dependencies

2.0.3:

warning Use 2.0.4 instead.

Bug Fixes

  • Adds possible solution in file fetching timeout messages

Maintenance

  • Update to third party dependencies

2.0.2:

Bug Fixes

  • JS files cannot be rendered as plain text and are shown as binary for download

  • Use timeout for fetching files of the file picker in the include macro dialog to prevent many Bitbucket requests for large repositories

  • Binary files like zips are displayed when included which causes page rendering issues

2.0.1:

Maintenance

  • Improved connection and socket timeout thresholds

Bug Fixes

  • When a Bitbucket file URL is pasted with no branch information and the default branch is different, the app will not find the file

2.0.0:

New Features

  • Included Bitbucket files get indexed and are now searchable within Confluence

    • Included Bitbucket files in Confluence pages using the app’s macro were not indexed so far, thus were also not available within Confluence search.

    • With this release, included Bitbucket files are now indexed and their content is available when searching in Confluence pages

    • This feature is opt-in and has to be enabled manually under Confluence admin → Include Bitbucket

Version 1.x

1.14.3:

Bug Fixes

  • Images in preview mode cannot be rendered anymore

1.14.2:

Bug Fixes

  • Copy to clipboard button doesn't work when macro is collapsed

  • Resize included images which are bigger then display width to size of display

  • Show content from a public repository, when a Confluence user does not have a Bitbucket account

1.14.0:

Maintenance

  • Removed support of using Additional Languages from Confluence Code Macro for syntax highlighting in included files from Bitbucket Server

    • Due to technical problems in combination with other apps not provided by us, we needed to remove syntax highlighting for custom Additional Languages.

    • The app falls back to “Plain Text” for existing macros and we also recommend to select “Plain Text”, if your file is not supported anymore.

Bug Fixes

  • When selecting Collapsible checkbox, “Expand source” button works again, independent of usage of some other apps

    • A change in version 1.13.3 in combination with some other apps broke the “Expand source” button, which is shown if the Collapsible checkbox is selected in the Include Bitbucket macros.

    • The ”Expand source” functionality work again with this release and we recommend to update if you are still using one of the following versions: 1.13.3, 1.13.4, 1.13.5 of the app.

  • Rendering of inline images in AsciiDoc respects attributes

  • Rendering of newlines in Markdown consistent with Bitbucket Server

    • The app now consistently renders single newlines in Markdown without a line break as Bitbucket does by default as well.