Workspace Integration

Manage integrated tools for the workspace: Login > Workspace Settings > Integrations

Use the “Integrations” tab within “Workspace Settings” to centrally connect your BetterBugs Workspace (that includes all the projects within the workspace) to your project management tools, issue trackers, communication software, and backend logger.

You can integrate them all in one go using the workspace-level integration.

You can also connect your project tool(s) at BetterBugs Project Level using project level integration.

Here, we've covered workspace-level integration and steps for it.

How to Integrate All Your Projects in a BetterBugs Workspace to your PM Tool: Linear Example

Steps to Integrate All Projects in BetterBugs Workspace with Your PM Tool: Video Demo | Linear Example

You can setup the workspace-wise integration as an "Admin" or a "Owner".

1

Open Workspace Settings > Integrations

Click on BetterBugs Workspace name at the top left side. Now, click the gear icon to open Workspace Settings > Integrations.

2

Select your preferred tool to integrate

In the Integrations tab, select your preferred tool and click on the tool's card. For instance, let's open Linear app's card.

3

Turn on workspace-wide integration

Make sure that that the toggle is ON for "All Projects".

By default, its turned on for workspace level integration.

4

Connect

Next, hit “Connect” at the top right.

5

Authorize BetterBugs.io

Hit “Authorize” to authorize BetterBugs.io for your Linear Workspace.

IMPORTANT NOTE

If you're on a free plan, Steps 6 and 7 are NOT REQUIRED. You can just SKIP to "How to Create Bug Report for A Specific Project in BetterBugs and Send to Your PM Tool: Linear Example".

FOR PAID PLANS (Teams and Enterprise)

Steps 6 and 7 enables you to explicitly choose between:

• Manual Ticket Creation (Default): This means for sharing a bug report to Linear, you'd need to manually populate fields for your Linear project (Team, Project, Priority, and others). Its a FREE FEATURE.

• Automatic Ticket Creation: This means for sharing a bug report to Linear, you can configure BetterBugs to auto-populate fields for your Linear project (Team, Project, Priority, and others). Its a PAID FEATURE.

6

Optional: Choose your preferred method for creating tickets

From the "Forward Bug Reports" dropdown, select your preferred method for creating tickets in your project tool:

• Manually: Enables you to create tickets manually. Here, we've selected the manual method to showcase workspace integration steps.

• Automatically: Enables you to create tickets with automation.

7

Optional: Select "Manually" and Connect

Finally, select "Manually" from the "Forward Bug Reports" dropdown and hit "Connect".

Okay! You're good to go with the Workspace level integration for your Linear app. All your BetterBugs.io projects (within the workspace that you’re currently in) are connected to your Linear Workspace.

You can follow the same steps as above for integrating other tools.

How to Disconnect Your PM Tool that's Integrated at the Workspace-level: Linear Example

Steps to Disconnect Your PM Tools that's Integrated at the Workspace Level in BetterBugs: Video Demo | Linear Example

1

Open Workspace Settings > Integrations

Click on BetterBugs Workspace name at the top left side. Now, click the gear icon to open Workspace Settings > Integrations.

2

Select your project tool

From the "Integrations" tab, select the tool that you want to disconnect. For the demo, let’s disconnect “Linear” (that's connected at the workspace level).

3

Disconnect

Click on the “Linear” card and hit the “Disconnect” button at the bottom right.

4

Confirm action

To confirm action, click "Disconnect" from the modal.

This instantly disconnects Linear app from your entire workspace.

How to Exclude or Disconnect BetterBugs Project(s) from the Workspace Level Integration

If you want to exclude some projects from your Linear app that’s integrated at the workspace level, you can do that too. Here are the steps for it:

Steps to Exclude BetterBugs Project(s) from the Workspace Level Integration: Video Demo | Linear Example

1

Open Workspace Settings > Integrations

Click on BetterBugs Workspace name at the top left side. Now, click the gear icon to open Workspace Settings > Integrations.

2

Select your project tool integrated at the workspace level

From the "Integrations" tab, select the tool that you want to exclude projects from. For instance, let’s exclude a project from “Linear app” (that's connected at the workspace level).

3

Open Linear card and turn off "All Projects"

Click on the “Linear” card. Next, toggle off "All Projects" and hit "Continue".

This enables the "Manage per project" integration mode and instantly shows a list of projects that're centrally connected to Linear at the workspace level.

4

Select BetterBugs project to disconnect and click (⋮) under "Actions"

Select the BetterBugs project (from the list below) to disconnect. For the project, click vertical dots (⋮) under the Actions column.

5

Disconnect

To confirm action, click "Disconnect" and "Continue".

This instantly disconnects the project from workspace wise integration with Linear.