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
-
In the Atlassian Marketplace, search for BrowserStack Test Management for Jira, then open its listing.

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.
-
Click Try it free.

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

The AI agents and the Jira reporting gadgets come with the Advanced edition.
-
On Review and install, check the details, then click Start free trial.

The app installs with a 30-day free trial. When the installation finishes, Jira confirms that it added the app to your site.
Link the app to a BrowserStack account
Setup cannot continue until this step is complete. The app stores your test cases, test runs, and reports in the linked account.
-
On the installation confirmation, click Get Started.

If you close the confirmation, see Reopen the setup screens.
-
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.

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

-
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.
-
-
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.

-
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.

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.

Until you enable the app for a project, the app does not appear in that project. To enable it, do the following:
- Under Enable app for Jira Projects, click Proceed.
- 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.
-
Click Save Changes.

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:
- Open an enabled Jira project.
- Select the BrowserStack tab. If you do not see the tab, select More, then BrowserStack.
- Create a test case, then save it.
- 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:
- In Jira, go to Settings > Apps > Manage apps.
- Under Apps, expand BrowserStack.
- Select Get Started.
You can also open the Get Started page from Atlassian Administration:
- Go to Site settings > Connected apps.
- Find BrowserStack Test Management for Jira in the list.
-
Select the more actions (β―) menu, then click Get Started.

Next steps
- Create test cases. Add test cases manually or generate them with BrowserStack AI.
- Execute manual test runs. Run your test cases and record results.
- Import test data. Bring test cases from Xray, Zephyr, or Zephyr Essential.
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
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!