Skip to content
Help Center
Browse documentation

Connect Jira and sync issue status

File the issues TestOptim finds into a Jira project automatically or by hand, and keep their status in sync both ways, with optional re-verification.

Updated 4 min read

To connect Jira to TestOptim, open your project's Integrations tab, choose Jira, select Connect to Jira and pick a Jira project. TestOptim then files the issues it finds as Jira issues and keeps their status in sync both ways.

Before you start

  • You need the Owner or Admin role.
  • Integrations are available on the Startup plan and above. On the Solo plan or a trial you see an upgrade prompt instead of the setup. See Compare plans and limits.
  • You need an Atlassian Cloud account with access to a Jira site and project.
  • Setup is per project.

Connect Jira

  1. Open the project, then select Integrations in the left sidebar.

  2. Open the Jira tab.

    The Jira tab showing Connect Jira with a Connect to Jira button
    Jira is connected per project

  3. Select Connect to Jira. You go to Atlassian to sign in and approve access.

  4. Back in TestOptim, if your Atlassian account has several Jira sites, pick one with Use this site. Choose Use a different Atlassian account if yours isn't listed.

  5. Choose the Jira project, the Issue type and, optionally, a Priority (the default is Jira default). If you can't see your project in the list, enter its key manually.

  6. Select Save project.

The card now says Connected and shows the Site, Project and Last sync. TestOptim registers the webhooks it needs in Jira for you.

Note

The Atlassian approval happens on Atlassian's own screens, so this article doesn't show them.

From the card you can also use Sync now, Test connection, Change project and Disconnect.

Decide how issues get to Jira

The settings card below the connection has an Automation section that controls this.

  • Create Jira issues automatically is on by default. Every issue found by a test run is filed in your Jira project as it is discovered. Turn it off if you'd rather choose.
  • To file an issue by hand, open it in TestOptim. The Jira panel shows Create Jira issue (or, once linked, the Jira key and a Pull latest button).
The Jira panel on an issue page before Jira is set up
Before Jira is connected, the panel points to Project Integrations

Warning

Because automatic creation is on by default, the next test run starts filing issues in Jira straight away. Turn the toggle off first if you don't want that.

Warning

Test runs file a new issue every time a test fails, so repeated runs of the same failing test create repeated Jira tickets. Turn automatic creation off if that is too noisy.

Keep statuses in sync

Changes go both ways. A status change in TestOptim is pushed to Jira: for example Fixed becomes Done and Rejected becomes Won't Fix. Pending verification is not pushed. When you set Fixed or Closed and TestOptim checks the fix, Jira is updated once the check ends, with the status the issue ends up with. A transition in Jira updates the TestOptim issue and appears in its activity.

In the same card, Status mapping lets you choose what each Jira status becomes in TestOptim. These are the defaults:

Jira status Becomes
To Do, Backlog, Selected Open
In Progress, In Review, In Testing In Progress
Done, Resolved, Approved Fixed
Closed, Archived Closed
Won't Fix, Cancelled, Duplicate Rejected
Reopened Reopened

Any Jira status not in the table, for example a custom status such as "Ready for QA", becomes Open in TestOptim. The mapper lists only the statuses above, and you can't add a row for a custom status.

Change a row with the maps to menu, then select Save changes.

Re-verify when Jira says Done

Run tests automatically on Jira status change is off by default. When on, moving a linked issue to a Done or Fixed status in Jira makes TestOptim re-check your live app before it marks the issue fixed. See Mark an issue fixed and let TestOptim verify the fix.

Frequently asked questions

Does Jira create tickets automatically?

Yes, by default. Create Jira issues automatically is on, so every issue from a test run is filed in Jira. Turn it off to create tickets by hand.

Which Jira plans are supported?

TestOptim connects to Atlassian Cloud sites through Atlassian's sign-in.

Fix common problems

  • "Jira rejected the connection test." The card shows Needs attention. The Atlassian approval may have expired or been revoked. Select Retry now on the card, or Reconnect to approve access again.
  • Nothing appears in Jira. Check that Create Jira issues automatically is on, or create the issue by hand. If it still fails, email hi@testoptim.com.