Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Bitbucket plugin not compatible to new version of Bitbucket (Atlassian Bitbucket v7.6.5)



We implemented a Bitbucket plugina couple of years ago, and the Bitbucket version at that time is v5.16.3. What the plugin does is to add a new tab in the pull request page and show customized information in the new tab.


The plugin worded fine until our Bitbucket server is upgraded to v7.6.5. I have made changes in the POM to picked up the latest Atlassian dependencies. After fixed some the compilation issues, the plugin package (.obr) can also be installed in the new BB server. However, the tab is not showing at all in the PR page. I did noticed that there is a new tab "Builds" in the new version's PR page.


Is this compatibility issue can be easily addressed with dependency updates and/or src\main\resources\atlassian-plugin.xml file? Or do we need to make extensive changes to the implementation of our plugin as well? If the latter, where can we find a good example to start with? 




Here is the atlassian-plugin.xml file with our group ID masked out:

<?xml version="1.0" encoding="UTF-8"?>

<atlassian-plugin key="${atlassian.plugin.key}" name="${}" plugins-version="2">
<vendor name="${}" url="${project.organization.url}"/>
<param name="plugin-icon">images/pluginIcon.png</param>
<param name="plugin-logo">images/pluginLogo.png</param>
<!-- add our i18n resource -->
<resource type="i18n" name="i18n" location="myPlugin"/>
<!-- add our web resources -->
<web-resource key="bitbucket-resources" name="Bitbucket Web Resources">
<resource type="download" name="highlights.css" location="/css/highlights.css"/>
<!--<property key="plugin-css" value="text/css"/>-->
<resource type="download" name="highlights.js" location="/js/highlights.js"/>
<resource type="download" name="builders.js" location="/js/builders.js"/>
<resource type="download" name="sessionCache.js" location="/js/sessionCache.js"/>
<resource type="download" name="utils.js" location="/js/utils.js"/>
<resource type="download" name="images/" location="/images"/>
<!-- <context>atl.general</context>-->

<client-resource key="soy-templates" name="Soy Templates for custom settings">
<directory location="/templates/" />

<servlet name="Highlights Servlet" i18n-name-key="" key="highlights-servlet" class="com.<my_group_id>.servlet.HighlightsServlet">
<description key="highlights-servlet.description">The Highlights Servlet Plugin</description>

<web-item key="pull-request-plugin-tab" name="Pull Request navigation tab" section="bitbucket.pull-request.nav" weight="60">
<link linkId="pullRequestHighlights">/plugins/servlet/highlights/${pullRequest.toRef.repository.project.key}/${pullRequest.toRef.repository.slug}/${}</link>

<client-resource key="pr-ccq-resources" name="Pull Request CCQ Resources">
<directory location="/ccq/css/" />
<directory location="/ccq/js/" />
<directory location="/ccq/templates/" />
<resource type="download" name="sessionCache.js" location="/js/sessionCache.js"/>


<client-web-panel name="PR CCQ link" key="pr-ccq-panel" location="bitbucket.pull-request.related-entities" weight="2000">
<resource name="view" type="soy" location="my-group-id.bitbucket:pr-ccq-resources/ccq.plugin.prOverviewPanel" />



And here are the part of the dependency versions from pom file:



1 answer

Hi @zhi zhang , starting from Bitbucket 7.0 the pull request page is using a new set of APIs called Client-Side Extensions. You will have to migrate your frontend plugin code to using CSE. You can read about this change here: API changelog page 

Here is the link to the guide on how to start using CSE:

Maciej Adamczak
Atlassian Developer

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Bitbucket

Git push size limits are coming to Bitbucket Cloud starting April 4th, 2022

Beginning on April 4th, we will be implementing push limits. This means that your push cannot be completed if it is over 3.5 GB. If you do attempt to complete a push that is over 3.5 GB, it will fail...

2,262 views 2 9
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you