Step-by-Step Integration of JIRA with Testlink

Jira testlink

Many of the agile based project management softwares that simplify user story based development, don’t lend themselves well for test management, giving rise to the need for test-suite centric softwares. While test management softwares make the life of a QA person much simpler, it gives rise to another complexity – managing a product backlog software as well as the test management software!

Testlink – an open source test management software – helps ease things by providing hooks to integrate with popular solutions like JIRA.

However, it’s not as straight forward as it sounds. When trying to integrate my project’s JIRA account, I found out that there is no single place where all the information was available. Since these two products are used quite commonly, I decided to compile all my learning at a single place, providing a step-by-step novice guide to integrate JIRA with your Testlink account, so that someone else attempting to do the same does not need to jump through so many hoops as I did. If you still face any problem, feel free to mention it in comments.

Step 1:

If you are not the admin of your testlink account, then ask them to create login credentials and assign your role for your project. Login with your credentials and Select “Issue tracker Management” from Dashboard to create Issue tracker that will link your JIRA account with your project.



Step 2:

On Issue tracker management click on “Create” button to create a new tracker where you have to provide details of your JIRA account.


Step 3:

Now you need to wire up the JIRA account by doing a few things:


  1. Provide a suitable name in Issue tracker field like ‘DemoTracker’ .
  2. Select type as jira(Interface: soap) if you are using JIRA as third party tool.
  3. Provide a suitable name in Issue tracker field like ‘DemoTracker’ .
  4. Select ‘Show configuration example’ to see configuration example of selected type – Jira in this case. Copy this sample in configuration field and change your details accordingly.


You can also copy the text written below in a configuration field and provide your Jira login credentials, replacing https://testlink.atlassian.net with the Jira link of your project:

<username>Jira Login Name</username>
<password>Jira Password</password>

  1. Click Save and your tracker gets created and you can see it in the tracker list.


Step 4:
tracker name

Click the tool icon placed next to the tracker name to activate your tracker. You would see a lighted lamp between icon and Tracker Name.


Step 5:

One could create a new project or navigate to an existing one and add the Issue tracker.

Follow the steps mentioned below to add Issue Tracker in your project:

  1. Click the Create button if you want to create a new project. For an existing project, select from the list.create
  2.  Login with admin user and Select Test Project Management.test project
  3. Enter the required information and select active checkbox to activate the integration.
  4. Select the issue tracker name (that you have created above) from Issue tracker integration drop down.
  5. Click on Save/Create button.  create tracker

When the integration is successfully configured, log in to TestLink and execute your test cases. When the test cases have been executed, access to bug management system will be available:

Click on icon under Bug management to report or add bugs attached to the test cases.


After clicking the icon, the following window will open:

bug id

You can directly refer to JIRA tickets by providing the ticket number. Otherwise click on the link ‘Access To Bug Tracking System’ to access JIRA. For first time access of JIRA via Testlink, you will be redirected to you JIRA Dashboard, prompting a login in order to create a new ticket.

create bug

After creating the bug in JIRA, return to TestLink window to add the ticket number. With this done, you can now seamlessly manage your JIRA bugs from within your test management software.

The process just takes a few minutes and now you can create bugs linked to your test suite with just one click.

Hope you find this helpful. 🙂

You might also like