Linear

Share bug reports as Linear issues in your workspace.

BetterBugs integration with Linear

BetterBugs integrates with Linear in just a few minutes, allowing you to share all your issues directly with your Linear workspace. This eliminates the need for back-and-forth communication and follow-ups, streamlining your bug-reporting workflows.

With BetterBugs, you can capture and share issues like a pro, providing your developers with all the details they need to debug faster, all through a simple link.

Steps to integrate BetterBugs with Linear

BetterBugs Integration with Linear

1

Install extension

Install the extension and pin it to the browser for quick access.

2

Capture the bug

Take a screenshot, record a video, or hit Rewind (if it's already enabled for the website).

3

Enter bug details

Add a title* (Required) and other bug details about the bug.

4

Connect with Linear

Open the "Send to your tools" dropdown from the top right corner of the screen. Click "Connect Linear" to authorize BetterBugs for Linear and connect your Linear Workspace.

5

Choose the BetterBugs workspace and project to connect

Below the "Send to your tools" dropdown, select the BetterBugs Workspace and Project to connect with Linear.

• Dropdown 1: User's Workspace (default: BetterBugs Workspace Name)

• Dropdown 2: User's Project (default: BetterBugs Project Name)

NOTE: The integration will happen to the specific project you selected within BetterBugs. This means that if you have multiple projects, you'll need to set up separate integrations for each one. You can also integrate your entire workspace with the tool.

6

Enter details for Linear

Next, click on the "Send to your tools" dropdown. Click "Linear issue".

This fetches the available Linear workspace fields for "Your Linear task info". Add details like Team, Parent Issue, Priority, Labels, etc.

7

Send report

Click on the "Upload Bug Details" button from down below.

This completes the integration.

A new tab with the created Linear Task opens up posting the Task to the Linear workspace containing all the details and a link to the complete bug report with developer tools info is included in the task. You can access the complete bug report on the BetterBugs Dashboard with all the information.

To check if the integration worked correctly and the report was shared with your Linear project,

1. Open the report that you just shared (using the Issue report link from the Linear task or your BetterBugs project).

2. Click on the Comments/Activities tab at the bottom right to check for a successful task creation message or any other activity on it. Make sure to enable the “Activities” with the toggle switch.

Steps to send an existing report to Linear

1

Login

Log in to your BetterBugs account.

2

Select project and open report

Select the project (within BetterBugs) that’s integrated with Linear. Open the report you want to share.

3

Enter details for Linear

Click "Send to your tools" from the top menu and select "Linear issue" from the "Select" dropdown. This will fetch the report template from Linear. Add details like Team, Parent Issue, Priority, etc.

NOTE: You can also update any details already available in the bug report.

4

Send to Linear

Hit the "Create Task" button.

A new tab with the created Linear Task opens up, posting the Task to the selected Linear Workspace, containing all the details and a link to the complete bug report with developer tools info.