Last updated May 7, 2024

Beginner guide to Bitbucket Data Center plugin development

Welcome to plugin development for Bitbucket Data Center. You will build a plugin with the same framework used in Jira and Confluence Data Center. If you have written Atlassian plugins before, you can use that knowledge to start from our experienced plugin development guide. Otherwise, the following tutorials provide a good introduction.

Note that these guides are for developing plugins to run on Server instances you host yourself. If you want to create an app for a cloud instance hosted by Atlassian then check out our cloud plugin development tutorials.


Here, you will find tutorials for different types of behavior in Bitbucket Data Center. Read through their summaries and choose one that represents something you are interested in or know about. Please note that all tutorials require you to install the Atlassian Plugin SDK.

After completing any of these tutorials, you will have learned to do the following:

  • Generate a Bitbucket Data Center plugin using the Atlassian Plugin SDK
  • Use various Bitbucket Data Center services
Adding an extension in the pull request overview panelCreate a plugin that puts custom content on the Overview tab of a pull request
  • Define a new Client-side Extension
  • Find Client-side Extension points in the Bitbucket Data Center UI for adding content
  • Use custom HTML and logic in your extension
Controlling when pull requests can be mergedOnly allow repository administrators to merge pull requests by writing a plugin containing a Merge Request Check
  • Implement a repository merge check in Java
  • Declare a repository merge check in your plugin's atlassian-plugin.xml
  • Internationalize your plugin's messages
Decorating the user accountWrite a plugin that decorates a user's account management page with custom content
  • Create a servlet that extracts an account management page
  • Add a new tab to the account management page
  • Decorate the account management page using Soy to render its content
Decorate the user profile pageWrite a plugin that adds custom content to the public user profile
  • Create a servlet that extracts a user's profile
  • Add a new tab to the user profile page
  • Decorate the user profile using Soy to render its content

Next steps

Now, you are ready to start developing your own plugins with the Atlassian plugin framework. If you would like to keep learning about plugin development for Bitbucket Data Center, continue with the following:

Rate this page: