What you’ll learn
- How to install the TestDino Forge app on your Jira Cloud site
- How to connect TestDino projects to the app
- How to view test cases, runs, sessions, and releases inside a Jira issue
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
Open the Marketplace listing
Go to the TestDino for Jira listing on the Atlassian Marketplace.
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.
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.Open the app dashboard
In Jira, go to Apps → TestDino to open the dashboard, then click Connect / Disconnect projects.
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.
Apply the selection
Click Apply to generate tokens and link the selected projects. TestDino confirms with a count of connected projects.
NoteThe 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.NoteLinking 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.
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.
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.
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 |
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
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
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
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
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