Last updated May 24, 2024

Writing and running plugin tests

This tutorial describes the concepts you need to understand, the tools you use, and processes you follow for testing a plugin in the Atlassian Plugin Framework.  You can use all of the concepts, tools, and processes described in this section with any plugin regardless of the plugin's intended host application (for example, JIRA, Confluence, or Stash). This section contains the following topics:

How to work through the tutorial

Beginners should work through each page sequentially as each new page builds on the material from the previous page. Each page concludes with a Next Steps heading that recaps and tells you where to go next. Beginners should allow two hours to work through the entire tutorial.

Experienced programmers or readers with previous knowledge of Atlassian plugin development processes, may choose to just skim or skip around. Each page encapsulates the core knowledge for each part of the testing process.

Check Your Work

We encourage you to work through this tutorial. If you want to skip ahead or check your work when you are done, you can find the plugin source code on Atlassian Bitbucket. Bitbucket serves a public Git repository containing the tutorial's code. To clone the repository, issue the following command:

git clone

Alternatively, you can download the latest source here:

Rate this page: