Skip to main content
What you’ll learn
  • How to connect your Linear workspace to a TestDino project
  • How to create prefilled issues from failed or flaky tests
  • How to manage the integration (sync, disconnect, change defaults)
The Linear integration creates prefilled issues in Linear directly from failed or flaky tests in TestDino. Each issue includes the test name, error details, failure history, code context, console output, screenshots, and links to the TestDino run and Git commit. This is a user-level integration. Each team member connects their own Linear account and creates issues under their own identity.
WarningAvailable on TestDino Pro, Team, and Enterprise plans.

​
Prerequisites

  • A TestDino project with test runs uploaded (Getting Started)
  • A Linear account with permission to create issues
  • A Linear team to file issues into

​
Connect Linear to TestDino

​
1. Open the Integrations page

Go to Settings → Integrations in your TestDino project. Find the Linear card and click Connect. TestDino Settings → Integrations page showing all issue tracking cards with Connect buttons

​
2. Authorize your Linear account

TestDino redirects you to Linear to authorize access. Sign in and approve the request. TestDino requests permission to read workspaces, teams, and create issues.

​
3. Configure defaults

After authorization, select the default Workspace and Team where issues will be created. You can change these per issue when creating a bug report. Linear connected configuration in TestDino showing default workspace selector, sync, and disconnect options
NoteThe default team is a convenience setting. You can select a different team each time you create an issue.

​
Create a Linear Bug Report

Create Linear issues directly from failed or flaky test cases. Each issue includes test metadata, so your team has full context without opening separate reports.
1

Open a Test Run

Navigate to a Test Run in TestDino.
2

Select a test case

Choose a failed or flaky test case from the run.
3

Raise Issue

Click Raise Issue and select Linear.Raise Issue button showing connected issue tracking integrations to select from
4

Configure & Create issue

Select the Workspace and Team. Set Issue Type, Priority, Labels, and Assignee as needed. Review the Summary and Description (auto-generated from failure data). Use the Write/Preview toggle to verify formatting. Click Create to file the issue in Linear.Linear issue confirmation showing issue key, ID, and link
5

Confirm creation

TestDino shows a confirmation with the Linear issue key and internal ID with a copyable URL. Click View in Linear to open the issue and continue triage.Linear bug report form in TestDino showing prefilled fields and description

​
What TestDino Pre-fills

Every issue is created with structured context so the developer receiving it has everything needed to investigate.
SectionFieldPre-filled Content
Linear FieldsWorkspace and TeamDefault from Settings is preselected
Issue TypeLinear issue types
PriorityLinear priority values
LabelsOptional routing labels
AssigneeOptional routing assignee
SummaryTitle based on test name with run context
DescriptionTest DetailsFile, branch, commit author/message, environment, run ID, duration, attempts
Why It FailedFailure cluster and the exact step or locator
Last Attempt SnippetShort code context around the failing line
Recent HistoryFailure frequency in the selected period
Console TailRecent relevant console output lines
LinksTestDino run, Git commit, CI job
ReviewWrite/PreviewVerify formatting before submitting
ScreenshotsListed thumbnails; attach more if needed

​
Troubleshooting

  • Click Sync on the Linear card in Settings → Integrations to refresh teams, labels, and templates from Linear
  • Verify your Linear account has access to the workspace and team you expect to see
  • TestDino automatically refreshes OAuth tokens when supported by the provider. If you still see authorization errors, click Disconnect on the Linear card, then reconnect and re-authorize
  • Ensure your Linear account has permission to create issues in the target team
  • The button appears on failed or flaky test cases inside a test run detail view. Open a test run and click into a specific failed test
  • Verify the Linear integration is connected for your account in Settings → Integrations
  • Use the Write/Preview toggle in the bug report form to verify markdown formatting before submitting
  • Linear renders markdown in issue descriptions. Complex code blocks may need manual adjustment