Skip to main content
Experience faster, smarter testing with BrowserStack AI Agents. See what your workflow’s been missing. Explore now!
No Result Found
Get your setup working faster. Join our Discord for optimisation tips from elite testers. Join our DiscordJoin our Discord

Get started with Test Management for Jira

Install BrowserStack Test Management for Jira, link it to a BrowserStack account, and enable the app for the Jira projects you test.

BrowserStack Test Management for Jira brings test cases, test runs, and reports into Jira. Setup has four steps, and every step runs inside Jira. You install the app, link it to a BrowserStack account, enable it for your projects, then confirm it works.

Before you start

Check these three requirements before you open the Atlassian Marketplace:

  • You are a Jira administrator. Only Jira administrators can install Marketplace apps, link the app to BrowserStack, and enable the app for projects.
  • You know whether your organization has a BrowserStack account. If it does, you link that account during setup. If it does not, you create one from the same screen. You do not need a BrowserStack account before you start.
  • You know who the BrowserStack group admin is. Linking an existing account needs group admin access on that account. If you are not the group admin, the app asks the group admin to approve you. Setup pauses until they do. To avoid the wait, ask the group admin to promote you in User Management before you start.
Role Responsibility
Jira administrator Installs the app, links it to a BrowserStack account, and enables the app for projects.
BrowserStack group admin Adds the Jira administrator to the BrowserStack group in User Management and promotes them to group admin. Opens none of the Jira screens in this guide.

Install and set up the app

To install the app and make it available to the projects you test:

Install the app from the Atlassian Marketplace

  1. In the Atlassian Marketplace, search for BrowserStack Test Management for Jira, then open its listing.

    The Atlassian Marketplace search results with BrowserStack Test Management for Jira among the BrowserStack apps.

    Several BrowserStack apps share similar names. Check that the app name matches exactly and that the publisher is BrowserStack. BrowserStack Test Management (Webapp) Integration for Jira is a different app. It connects Jira to the BrowserStack Test Management web app and is not covered by this guide.

  2. Click Try it free.

    The BrowserStack Test Management for Jira listing with the Try it free button on the Atlassian Marketplace.

  3. In Select an edition and site, choose the Standard or Advanced edition, select your site, then click Review.

    The Select an edition and site step with the Standard and Advanced editions and the Jira site selector.

    The AI agents and the Jira reporting gadgets come with the Advanced edition.

  4. On Review and install, check the details, then click Start free trial.

    The Review and install step with the edition summary and the Start free trial button.

    The app installs with a 30-day free trial. When the installation finishes, Jira confirms that it added the app to your site.

Setup cannot continue until this step is complete. The app stores your test cases, test runs, and reports in the linked account.

  1. On the installation confirmation, click Get Started.

    The installed app page in Jira with the Get Started button.

    If you close the confirmation, see Reopen the setup screens.

  2. On Connect with your BrowserStack Account, wait while the app checks for an existing account.

    The app matches your email domain against BrowserStack groups and shows one of these options:

    • Link an existing BrowserStack account when a paid account exists with no Test Management subscription.

      The Connect with your BrowserStack Account screen with a paid account found, showing the Link an existing BrowserStack account and Create a new BrowserStack account options.

    • Create a new BrowserStack account when no paid account exists.

      The Connect with your BrowserStack Account screen with no paid account detected, showing the admin email search and the Create a new BrowserStack account option.

    • Contact Support when the account already has a Test Management license. The same option appears when two or more paid groups match your domain. Setup cannot continue until support resolves it.

  3. Click the button for your option:

    • To link the account shown, click Proceed. The screen names the account, its member count, and its group admin.
    • To link a different account, enter its group admin’s email under Looking for a different account?, then click Search. Every BrowserStack group has a group admin, so that address identifies the group.
    • To create an account, click Create. BrowserStack creates a new group with you as group admin, then returns you to setup. Nothing carries over from another account.

    The matched BrowserStack account with its member count and group admin, above the Looking for a different account? search.

  4. If you linked an account where you are not the group admin, wait for approval.

    The screen shows Waiting for BrowserStack admin approval and names the address to contact. The app emails that group admin. After they add you in User Management and promote you to group admin, the link completes on its own. You do not need to restart setup.

    The Waiting for BrowserStack admin approval message with the group admin address to contact and the linked account.

Enable the app for your Jira projects

After the account is linked, the Get Started page opens with two options:

  • Start with a Demo Project. Click Create to explore the app in a ready-made project with sample data.
  • Enable app for Jira Projects. Click Proceed to turn on Test Management for the projects you test.

The Get Started page with the demo project and enable-for-projects options.

Until you enable the app for a project, the app does not appear in that project. To enable it, do the following:

  1. Under Enable app for Jira Projects, click Proceed.
  2. On Select the projects to enable Test Management, turn on the toggle for each project you want. To enable every project at once, click Enable for all.
  3. Click Save Changes.

    The Select the projects to enable Test Management screen with per-project toggles and the Save Changes button.

If your project uses custom screens or workflows, the app prompts you to add required fields to those screens. Accept the changes.

Verify the setup

Confirm the app works in one of your enabled projects:

  1. Open an enabled Jira project.
  2. Select the BrowserStack tab. If you do not see the tab, select More, then BrowserStack.
  3. Create a test case, then save it.
  4. Create a test run, add the test case to it, then record a result.

When the test case and test run save without errors, your setup is complete. Everyone with access to the project now sees the BrowserStack tab. From it, they can work on test cases, test runs, and reports.

Reopen the setup screens

You can return to the Get Started page at any time. For example, you can enable more projects later. To open the page, do the following:

  1. In Jira, go to Settings > Apps > Manage apps.
  2. Under Apps, expand BrowserStack.
  3. Select Get Started.

You can also open the Get Started page from Atlassian Administration:

  1. Go to Site settings > Connected apps.
  2. Find BrowserStack Test Management for Jira in the list.
  3. Select the more actions (β‹―) menu, then click Get Started.

    The Connected apps list with the app's more actions menu open on Get Started.

Next steps

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback!

Talk to an Expert
Download Copy Check Circle