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

How to configure QAlity - Test Management for Jira for the first use?

QAlity - Test Management for Jira and QAlity Plus - Test Management for Jira are test management tools available for Jira Cloud and Jira Server. Even though QAlity is capable of configuring most of the required things upon install, there’s just a tiny bit of the configuration required from your side as well. This short guide explains how to get started with the QAlity on your instance.


Step 1: Installation

The first step is to install the app on your instance. The steps will differ depending on whether you use Jira Cloud or Jira Server. In either case, the installation steps are listed on the marketplace page for QAlity. You will also be able to install it directly from the marketplace page, by clicking “Get it now”.


Step 2: Configure issue types

Once the app is installed, it will automatically add the “QAlity Test” issue type to your Jira instance. You can recognize it with the following icon.



In order to use this issue type, you will need to enable it for your project though. Setting up the “QAlity Test” issue type is a little different for the team-managed projects on Jira Cloud and is explained in detail below.

For company-managed projects on Jira Cloud and on Jira Server, you will be informed about the need to enable the “QAlity Test” issue type when you view any issue in your project. The following information shows up when you did not enable the required issue type yet. Jira administrators can click on the “Go to configuration” to set up the QAlity Test issue type for the project.


The configuration should display currently enabled issue types as shown below. In order to modify them, click on Actions and Edit issue types.


This will bring you to the screen that displays issue types in two columns. One column showing the issue types that are currently enabled. And another column displaying issue types that are available, but not enabled. Move the “Test case” issue type from one column to another, in order to enable it and then confirm it by clicking on Save. That’s it! The Test case issue type is now enabled.



Configure issue type for team-managed projects

Team-managed projects use simplified configuration and therefore setting up the issue types works in a different way. Similar to company-managed projects, you will be informed about the need to enable the issue type as soon as you enter any of your Jira issues. A Jira administrator can click on “Go to configuration” to set up issue types. 

Available issue types will be shown in the menu on the left-hand side. In order to add a new issue type, you need to click on the “Add issue type” button.


This will display a dialog that allows you to provide the details for the new issue type. Please note that the new issue type must be named QAlity Test. You can also use the icon that was attached above in order to easily distinguish this issue type from others. 


Confirm the addition by clicking “Create” and the configuration is done!


Step 3: All set

Once you have enabled the issue type, you should be able to create and manage test cases in your project. The issue view should have the following section.

If you can see it, it means that you are all set to start using the app!


QAlity - Test Management for Jira is available for Jira Cloud and Jira Server on the Atlassian Marketplace free of charge. There's also a free trial available for QAlity Plus - Test Management for Jira. Have any questions or troubles setting up the app? Check out our documentation or contact our support team.


does qality work on free jire boards as well in the next gen projetcs ? 

@Simi Kaminiyes - QAlity is free for any Jira plan you have. It also works in Next-Gen projects - the instructions above explain how to configure it in Next-Gen :)

Hi. Is it possible to make this plugin dissabled by default for any project and then turn it on one by one project when necesary? I have instaled the plugin only form one of the projects in my enviroment for test purposses, but it shows up in each one - on every issue tracked there is QA section. As a JIRA Adm I have a list of the projects empty to enable /disable the plug-in but "enable default" checkbox is alway turned on. With a different account, as PM for two projects I can see this setting and I can dissable/enable this funcionality  for the project, but only the one I am responssible for. So as uber-admin I can't manage it, I have to tell all project-ressposible admins to turn this off / dissable on each project.

Do I miss something or I did during instalation process? (JIRA 7.2.2)

Hello Jacek,

the screen you are describing should be displaying all of the projects you administer and allow you to turn QAlity on and off in them one by one, or in your case - turn QAlity off in all but one project.

Are you sure that the user you attempt to use indeed has administration rights to all of the projects? Perhaps his permissions are somehow limited? If you can't figure this out, please feel free to reach our service desk - and we will do our best to help. If you decide to contact us via the service desk, please also include the QAlity version you are using.

Best regards,

Hello Sebastian. 

You are right, I was missing the administrator role in projects to see them all in my list in the plug-in configuration screen. Now I am able to enable/dissable plug-in for selected projects.

Thank you!

Best Regards 


Like Sebastian Brudziński likes this

Will there be a server version for this app?

Hello @Fernando André there's a server version of QAlity -

QAlity Plus will also have the server version (later this month) and a Data Center version (coming up in the next few months)

HI To create a new test case, click + Test Case is not enabled  

may I know how to enable this Test case link ??

@Sebastian Brudziński  does this tool support API integration ? if I want to integrate with python or java and update the test case after my test suite runs


@Mayank Kodesiaunfortunately, we don't have any APIs available yet that would allow you to integrate with QAlity from external tools.


While importing test cases from CSV file, can we map the steps and expected result from CSV to the QAlity-Test Steps and Expected Result?

Hello @Renu 

yes you can - take a look at the mapping step of the Import process in our docs -

Feel free to contact us if you had any problems achieving this and we will gladly assist -

Best regards,

Hello @Sebastian Brudziński  

Thanks for your quick reply!

Here is the issue - I am not able to select Jira field as Steps/Expected Result while mapping the fields.


Hi @Renu 

when you say you are not able to select "Test step" or "Expected result" do you mean that this option is not available in the dropdown? Or does the dropdown not open at all when you click on "choose something"? Perhaps something else happens? Have you tried a different browser? It would be great if you forwarded this problem and answers to the above questions to our customer service desk, they will be able to quickly answer and help -


how can I add custom fields into Quality Screen?


Log in or Sign up to comment
Community showcase
Published in Apps & Integrations

Marketplace Partner Spotlight: AppLiger

This month the spotlight is on AppLiger. We caught up with Pavel Pavlovsky, CEO and Product Manager, to learn how the company started and what fuels the team's creativity.    Atlassian:...

381 views 0 7
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