Linear integration

Each connection targets one Linear team. Connect Linear again to send reports to another team.

• You've created an app in the BugScreen console.
• You can sign in to a Linear account that's allowed to authorize applications in the workspace you want reports filed into.

1. Open your app in the console and find Connected destinations.
2. Open the Add integration menu and choose Linear. You'll be redirected to Linear to authorize BugScreen.
3. Approve the authorization. To restrict which teams BugScreen can reach, use Linear's Team access control on the same screen — it offers All public teams by default, or Only select teams.
4. Back in the console, pick the team reports should be filed into, then confirm. The workspace is shown but not editable — it's settled by the authorization you just gave.

Each report becomes one issue in the chosen team:

• A title starting with the tester’s selected Type, such as Question: …, followed by their description, collapsed onto one line and trimmed with an ellipsis if it runs long. When no Type is submitted, the title is the description alone.
• A description carrying the full report text, the reporter's type and severity, the test account if the app supplied one, and the device, OS and app metadata.
• The screenshot and the log file.

• Type matches an existing Linear label by name, ignoring capitalisation. A Question report matches a Question label, including a label inside a group.
• Create matching labels in Linear for the Type choices you want to label. BugScreen does not create or rename them.
• If there is no matching label, or Type is off, the issue has no Type label. Severity maps to priority separately.

Screenshots and the log file

These are uploaded into Linear before the issue is created, and appear in the issue description: screenshots inline as images, the log file as a View Logs link.

If an upload fails, the issue is still created with that attachment absent rather than being lost — so a report always reaches you, even when one of its files does not.

Priority

The reporter's severity maps onto Linear's built-in priority: high becomes High, medium becomes Medium, low becomes Low. Urgent is deliberately left free for your team to set by hand, so it keeps meaning what you decide it means. A report submitted without a severity gets no priority field, which Linear shows as No priority.

After connecting, use Test integrations to confirm everything works end to end. It fires a sample report at every integration connected to this app, not just this one. The test creates a real sample issue in the team and shows you whether it succeeded.

There's no in-place edit: to file into a different team, disconnect the integration and connect Linear again, picking the new team. Disconnect from the app's Connected destinations to stop creating issues, and BugScreen asks Linear to revoke its access token.

If a test or real report fails to reach Linear, check the following:

• Reconnect needed. Access has expired or been revoked. Reconnect Linear from the console.
• Issues arrive without the screenshot or log file. The connection predates a change in what BugScreen needs from Linear, and an existing authorization is never updated in place. Disconnect and reconnect to bring it up to date.
• Degraded. Linear is rate-limiting us. Deliveries retry, and the status clears on the next report that gets through.
• The team was archived, or the grant no longer covers it. Reconnect Linear and pick a live team — and if you restricted Team access on Linear's authorization screen, check the team you want is in that selection.
• Connect is blocked with a plan-limit message. Your plan's integration limit has been reached — remove an unused integration or upgrade your plan.