Jira Forge App

Install the TestDino Forge app to view linked test cases, runs, sessions, and releases inside Jira issues.

The TestDino for Jira Forge app links TestDino test cases, manual runs, exploratory sessions, and releases to Jira issues. You create the link from TestDino; the app shows the linked items in a panel on the matching Jira issue, so testing progress is visible without leaving Jira.

The app pairs with the Jira Issue Integration. That integration connects Jira to TestDino and creates and links issues from your test entities. The Forge app is the Jira-side view of those linked items. Use both together.

Warning

Jira Cloud only. The app runs on Atlassian Forge and installs from the Atlassian Marketplace.

Connecting a TestDino project requires a Team or Enterprise plan.

Quick Reference

Task	Where	Link
Install app	Atlassian Marketplace	Install
Connect a project	App dashboard	Connect
Link a test entity	From TestDino	Link items
View linked items	Jira issue panel	Issue panel
Track releases	Jira issue panel	Releases
View connected projects	App dashboard	Dashboard

What You Can Link

The panel surfaces four TestDino entity types linked to a Jira issue, each on its own tab. The status shows inside the issue, so the Jira owner sees test progress without opening TestDino.

TestDino entity	What it tracks	Status shown in Jira
Test case	A single test case	Active, Draft, Deprecated, Retired, Under review, Rejected
Manual run	A test case result in a manual run	Untested, Passed, Failed, Blocked, Skipped, Retest
Session	An exploratory testing session	Findings status
Release	A TestDino release and its testing scope	Not started, In progress, Completed

Prerequisites

• A TestDino project with test data (Getting Started)
• A Jira Cloud site with permission to install Marketplace apps
• Jira project access for the issues you want to link

Install the App

1. Open the Marketplace listing

   Go to the TestDino for Jira listing on the Atlassian Marketplace.

2. Install to your site

   Click Get it now and select the Jira site to install to. The app is free now. A Jira admin approves the install if you lack admin rights.

3. Approve the scopes

   The app requests read access to issues and app storage. It reads issue context and does not modify your Jira issues.

Connect a TestDino Project

Pick which TestDino projects appear in Jira from the app dashboard. Clicking Connect opens the TestDino connection flow, which generates the access token and saves it to the Forge app for you. There is no token to copy or paste.

1. Open the app dashboard

   In Jira, go to Apps → TestDino to open the dashboard, then click Connect / Disconnect projects.

   
2. Select projects to connect

   A TestDino window opens listing your organizations and their projects. Tick the projects to link to this Jira site. Use Select All or Clear per organization. Already-connected projects show a Connected badge. Some organizations may require a plan upgrade to connect.

   
3. Apply the selection

   Click Apply to generate tokens and link the selected projects. TestDino confirms with a count of connected projects.

   
4. Return to Jira

   Click Done and close the window. The Jira app updates automatically and the dashboard shows the connected projects with their entity counts.

Note

The connection flow generates a project access token per selected project and saves it to the Forge app. You manage these tokens by reconnecting or disconnecting projects here, not by copying keys.

Link Test Entities to an Issue

Linking starts in TestDino, not in Jira. A TestDino test case, release, session, or manual run result has a create and link Jira issue option. Once linked, the item shows on the matching Jira issue, and the Forge app renders it in the issue panel.

Note

Linking from TestDino requires the Jira OAuth integration connected under Settings → Integrations → Jira. See the Jira Issue Integration page for that setup. The Forge app provides the Jira-side view of the items you link there.

1. Link from a TestDino entity

   In TestDino, open a test case, release, session, or manual run result and use its option to create and link a Jira issue. The link records the issue on both sides.

   
2. Add the TestDino panel to the issue

   Open the linked Jira issue. Click the apps (gear) button near the issue title, then select TestDino to add the panel.

   
3. View linked items in the panel

   The TestDino panel opens with tabs for Test Cases, Releases, Manual Runs, and Sessions. Each tab lists the items linked to this issue. The panel shows a last-synced time with a refresh button.

   

Track Releases and Sessions

Releases and sessions give the Jira owner a view of testing scope beyond a single test case.

Link type	What the Jira owner sees
Release	Release readiness, testing progress, and bugs tied to the release
Session	Exploratory findings, notes, and defects captured during the session

From TestDino, link a release to an epic or a tracking issue to follow readiness as the release is tested. Link a session to the issue that prompted the exploratory work, so findings and defects stay attached to that issue. Both appear in the issue panel under the Releases and Sessions tabs.

Project Dashboard

The dashboard aggregates totals across all connected projects, then breaks them down per project. The Linked count under each total is how many of that entity are attached to a Jira issue.

Card	Shows	Linked count means
Test Cases	Total test cases across connected projects	Test cases attached to a Jira issue
Releases	Total TestDino releases	Releases attached to a Jira issue
Manual Runs	Total manual run executions	Runs attached to a Jira issue
Sessions	Total exploratory sessions	Sessions attached to a Jira issue
Projects	Connected TestDino projects	—

Troubleshooting

TestDino panel not visible on the issue

• Add it: click the apps (gear) button near the issue title and select TestDino
• Confirm the app is installed and a TestDino project is connected in Apps → TestDino

Panel shows no linked items

• Items are linked from TestDino, not from the panel. Link a test case, release, session, or manual run result to the issue in TestDino first
• Linking from TestDino needs the Jira OAuth integration in Settings → Integrations → Jira. See Jira Issue Integration
• Click the refresh button on the panel to pull the latest links

Linked item shows no status

• Status reflects TestDino data. Confirm the linked test case, run, or session has results in TestDino
• Use the refresh button on the panel to re-sync

Install blocked by Jira admin

• Marketplace installs need admin approval on most sites. Request approval from a Jira admin, or have them install from the Marketplace listing

Related

Jira Issue Integration

Create Jira issues from failed or flaky tests inside TestDino

Generate API Keys

Project access tokens for CLI uploads and the API

Manual Testing

Releases, manual runs, and sessions you can link to Jira

All Integrations

Issue tracking, CI/CD, and communication connections