Plugin Framework Documentation

All Versions

Plugin Framework 2.2

Plugin Framework Documentation

Atlassian's plugin framework allows developers to create plugins which extend the functionality of Atlassian applications such as JIRA, Confluence and others.

Almost every Atlassian application includes a version of the Atlassian Plugin Framework, however, they may not all have the same version. Please refer to the version matrix to see which version of the framework your application supports.

Table of Contents:

About this Documentation

This documentation contains version-specific information about the Atlassian Plugin Framework 2, i.e. the plugin library which is part of the plugin development platform. The Plugin Framework is under continuous development. With each new release, we may include new plugin module types and other improvements.

This documentation will be under version control, so that at any time you can read about the components of a particular version of the Plugin Framework.

For more general and static information about writing plugins and using the new plugin development platform, please take a look at the Atlassian Developer Network.

Download

You can download the Plugin Framework documentation in PDF, HTML or XML formats.

Current released version
Atlassian Plugin Framework 2.2.3 is now available — see the Plugin Framework 2.2.3 Release Notes.
About Atlassian Plugin Framework 2


The Atlassian Plugin Framework 2 replaces the original Atlassian Plugins framework, described in the Developer Network. The new framework is based on OSGi, a dynamic module system for Java.

About Plugins


A plugin is a bundle of code, resources and configuration files that can be dropped into an Atlassian product to add new functionality or change the behaviour of existing features.

Every plugin is made up of one or more plugin modules. A single plugin may do many things, while a plugin module represents a single function of the plugin.

There are two versions of plugins in the Atlassian Plugin Framework 2:

  • Version 1 — These may be static (deployed in WEB-INF/lib) or dynamic (via the web UI, only in Confluence) and should work the same as they did in version 1 of the Atlassian Plugin Framework. The capabilities and features available to version 1 plugins vary significantly across products.
  • Version 2 — These plugins are dynamically deployed on an internal OSGi container to provide a consistent set of features and behaviours, regardless of the application the plugin is running on. Version 2 plugins have to be specifically declared as such, using the pluginsVersion="2" attribute in atlassian-plugin.xml.
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.


Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.