How to Integrate JIRA with qTest: A Step by Step Guide

qTest for Jira Test Management Tutorial:

Atlassian Confluence was explained in simple terms in our previous tutorial.

At STH, we are all about sharing the best practices, tools, techniques, processes, tips and everything else that we have enjoyed learning and benefited from using. We believe this makes day to day tasks easier and helps us all grow as testers.

Suggested Reading => In-Depth Training tutorials on JIRA

Today is one such attempt – the integration of JIRA with qTest to gain the benefits of test management linked to requirements management. 

qTest for Jira

What is JIRA?

JIRA is a leading issue and project tracking tool catering to agile QA and development teams. JIRA allows you to manage and track any kind of unit work in the form of “issues” bugs, stories, project tasks with a predefined workflow.

Also read => Complete JIRA tutorials

Now, What is qTest?

qTest by QASymphony is a test management solution that allows teams of all sizes the ability to easily, manage, organize and report on software testing and test case management efforts.

Also read => Hands-on qTest review

Why should you integrate JIRA with qTest?

When you pair JIRA’s best-of-breed issue and project tracking capabilities with qTest’s innovative test case management abilities, the result will change the way your development and testing teams work.

Here are just a few of the benefits for integrating JIRA and qTest:

  1. Seamlessly move requirements and defects from qTest into JIRA
  2. Get test coverage reports for JIRA issues
  3. Real-time bug status changes viewable against Test Run Executions
  4. Easily access a detailed traceability matrix report of requirements and test case associations
  5. Autofill test run results in JIRA issues. No syncing required!

Great, how to integrate and what do I need?

Check out this JIRA test management integration video for all you need to know about this. The integration is seamless and super easy to set up.

OK, the tools are connected. Now, what?

Let’s start working through the steps of the resulting integrated requirement-test-defect management solution.

First of all, notice how the interface changes. You will no longer see the “defects” tab. This is because all defects raised through qTest will be created in JIRA as issue type “BUG”.

JIRA and qTest integration 1

Check this- no defects tab.

JIRA and qTest integration 2

Step #1: Retrieve requirements.

Requirements are always managed in a centralized way from JIRA. That part stays as is. But test management should start from requirements too, shouldn’t it? So, instead of having to create a brand new instance, the integration provides a way in which a certain issue type from JIRA can be retrieved into qTest.

Usually, the requirements are of the issue type- “New feature”, “Improvement” or “Story”.

Once requirements are downloaded, they would appear as:

JIRA and qTest integration 3

Note that, the icons are different. The JIRA and qTest ID’s both exist; JIRA and qTest properties too. These requirements are read-only here. They can be linked to TCs that exist within JIRA. Any changes to these requirements in JIRA are reflected on refresh.

Step #2: Create test cases and link them to requirements

This process is the same with or without JIRA integration. The test cases once linked to a requirement (retrieved from JIRA) will result in a JIRA issue link so the developers can see the test/tests associated with it.

This not only improves awareness of what the cross-functional teams are up to, but also supports test-driven development.

Check out the link as it appears in JIRA:

JIRA and qTest integration 4

Step #3: Create test cycles and run

This step too does not change at all with the integration. Test teams would go ahead and create Test cycles and/or Test suites within qTest and carry out test execution.

If a certain Test run results in a failure or if a defect reported is linked to a Test run, then this relationship reflects in JIRA. Two things happen here:

Number one: The defect gets linked to the requirement (if the test case was linked to a retrieved JIRA requirement).

JIRA and qTest integration 5

Number two: The defect will get a link to the Test run whose failure resulted in the issue.

JIRA and qTest integration 6

Step #4: Report defects

When a test run or a test step failure results in a defect and a qTest user clicks on the “BUG icon-”, JIRA Create Issue page (with issue type: Bug, auto selected) opens up automatically. Enter the information and create the issue.

The links are created as described in the earlier step.

JIRA and qTest integration 7

Step #5: Analytics and Reports

For a quick look up on the JIRA-qTest integration, JIRA users are provided with a qTest Widget. The following information is available on a real-time basis:

  • Unresolved Defects: By Test Run Status
  • Resolved Defects: By Test Run Status
  • Synced Requirements without Test Case
  • Top 10 Synced Requirements with Defects submitted from qTest

Integrate JIRA with qTest 8

qTest reports are all available as usual and can be created around JIRA retrieved assets too.

Benefits of integrating qTest and JIRA

#1) Testers can be testers and developers can be developers. I mean, test management systems are built for testers. Take a look at the qTest UI. The sequence of actions you would normally perform in a test project (STLC- Requirement gathering-Test design-Test execution-defects) is how the interface is organized. JIRA is more development centric, so you will not find this structure there.

#2) If your team is into TDD or BDD, your development teams can view the tests created and linked to each requirement right from their JIRA interface.

#3) Any updates to the requirements are automatically refreshed into qTest. So there will never be a discord.

#4) Defects are centralized in JIRA. It does not mean qTest users have to log out of their qTest instance when they have to log a defect. When you choose the option to log a bug, qTest automatically invokes the JIRA instance and returns back to the qTest when the bug is submitted.

#5) Developers can see the “Test run” information linked to a defect, so if there are multiple runs or if the developer wants to know if the defect was retested as the latest test run or not, they can do that from the JIRA interface itself.

#6) Reports both at JIRA and qTest. Through the qTest Widget in JIRA, the analytics can be viewed that show the highlights of the integration. qTest reports, on the other hand, use the JIRA retrieved elements to provide test statistics.


As always, we hope you find this tutorial interesting and useful.

Tool collaboration is a trend that QA and development teams are most thankful for (at least I hope they are) and integrations for JIRA test management, specifically qTest, is a definite benchmark.

Do give it a try and let us know if this worked for your team! Your feedback, comments and questions are most welcome!

PREV Tutorial | NEXT Tutorial

Recommended Reading

9 thoughts on “How to Integrate JIRA with qTest: A Step by Step Guide”

  1. Thanks.
    what is difference between jira and qtest?

  2. Thanks for this information.
    Workplace we are using JIRA.(Workflow, work assignments, projects) I think it would be very good.

  3. Pretty interesting piece, especially the benefits part. 🙂
    I could also recommend reading this article on functional testing (also with integration with Jira). Please tell me what you think.
    All the best!

  4. @Aasha: They are solutions targeted at two different areas. qTest is an End-to-End test management system while JIRA is for issue tracking. Check out the beginning of this article for more information

  5. @ Gözde: Thanks for stopping by! Please go give it a try and let us know your experience

  6. Is there any point in using the free qTest add-on ( if you do not have a paid qTest Manager license (and don’t plan on getting one)? Just wondering if you can muscle through on this free plugin with custom config in your Jira instance, and achieve the same desirable results as you’d get with a paid qTest Manager license. Thanks in advance for any insight!

    • No, the plug-in is free but only works with a qTest instance in place. Nothing is actually stored in JIRA, the plug-in creates an issue panel that pulls data from qTest.

  7. HI,
    Can we export test cases from spreadsheet/Excel/Word documents to Q test..?

  8. Very interesting article!

    I know that Tasktop also offers an integration between Jira and qTest, along with integrations to tools like HP (now Micro Focus) Quality Center. It’s interesting how so many tools work together these days. Great article, please keep them coming. Oh, and by the way – the link below is for Tasktop.


Leave a Comment