Work with Tests in Jira

This guide explains how to create, edit, link, and manage Suites, Tests, and Plans in Jira using the Testomat.io plugin.

How to Work with Suites

Create and manage Suites in Jira — organize related tests and link them to issues using the Testomat.io plugin.

How to Create a Suite

1. Navigate to the Suites tab
2. Click the menu button (⋯) and select New Suite

3. Enter the suite’s name and description below (optional)
4. Click Create button

5. Select a parent suite from the dropdown or Root destination
6. Click Save button

How to Edit a Suite

1. Navigate to the Suites tab
2. Click the pen icon near the suite you want to edit

3. Edit the suite (Suite title, description)
4. Click Update button

How to Link and Unlink a Suite

To link a suite to a Jira issue:

1. Navigate to the Suites tab
2. Click the menu button (⋯) and select Link Suite

3. Select a parent suite from the dropdown
4. Click Save button

To unlink a suite:

1. Navigate to the Suites tab
2. Сlick the trash can icon next to the linked suite
3. Once the modal window opens, confirm by clicking Unlink button

How to Work with Tests

Manage your tests directly in Jira — create, edit, and link them to issues or plans within the Testomat.io plugin.

How to Create a Test

1. Navigate to the Tests tab
2. Click the menu button (⋯) and select New Test

3. Enter the test’s name and optional description
4. Click Create button

5. Select a suite from the dropdown
6. Click Save button

How to Bulk Create Tests

Quickly create multiple tests at once directly from Jira.

1. Navigate to the Tests tab
2. Click the menu button (⋯) and select Bulk Create

3. Select the existing suite from the dropdown list
4. In the Add new tests field, enter test titles — each line corresponds to the title of a new test
5. Click the Create button to add all listed tests to the selected suite

How to Edit a Test

1. Navigate to the Tests tab
2. Click the pen icon near the test you want to edit

3. Edit the test (Test title, description)
4. Click Save button

How to Link and Unlink a Test

To link a test to a Jira issue:

1. Navigate to the Tests tab
2. Click the 🔗 Test button with the link icon

3. In the opened window, use filters to find the needed tests:

• Select a suite in the Search a suite dropdown
• Select a plan in the Search a plan dropdown
• Optionally, enter a tag in the Type @tag and press ‘Enter’ field
• Combine filters using AND or OR to refine search results

4. From the list of found tests, click the Link button next to a test to connect it to the Jira issue

• You can also click Link All to link all displayed tests

To unlink a test:

You can unlink tests from a Jira issue in two ways:

• via the menu button (⋯)
• through the 🔗Test button

Option 1 — via the menu button (⋯)

1. Navigate to the Tests tab
2. Click the menu button (⋯) and select Unlink Test

3. Select tests to unlink:

• By default, all tests are selected for unlinking
• If you don’t want to unlink all tests — uncheck the box next to the specific tests
• To unlink only selected ones, uncheck All tests first, then select individual tests you want to unlink

4. Click the Unlink button to confirm

Option 2 — through 🔗Test button

1. Navigate to the Tests tab
2. Click the 🔗 Test button with the link icon

3. In the opened window, find linked tests — Click Unlink next to the test you want to remove
4. Or click Unlink All to detach all linked tests at once

How to Work with Test Plans

Link and execute Test Plans directly from Jira to track and manage testing progress.

How to Link a Test Plan

1. Navigate to the Plans tab
2. Click the 🔗 Plan button or menu button (⋯) and select Link Plan
3. Click Link button

How to Unlink from a Test Plan

1. Navigate to the Plans tab
2. Click the 🔗 Plan button, or
3. Click the trash can icon next to the linked plan
4. Click the Unlink button to confirm

How to Work with Feature Files (BDD)

Edit and update BDD Feature Files from Jira and sync changes with your Testomat.io project.

How to Edit a Feature File

1. Navigate to the Test Coverage tab
2. Click the menu button (⋯) and select Edit Feature

3. Select the suite you want to edit in the Feature File
4. Edit the Feature File
5. Click the Update button