# Workspace Integration

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.

{% hint style="success" %}
You can also connect your project tool(s) at **BetterBugs Project Level** using [project level integration](/dashboard/workspace-settings/integrations/project-integration.md).
{% endhint %}

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

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FtoxIMlBosLmdfxDHfCjk%2F01-BetterBugs-Integration-with-Linear-Workpace-wide.mp4?alt=media&token=c3bf7eed-c2d6-47fa-a229-1d65d33ad42b>" %}
Steps to Integrate All Projects in BetterBugs Workspace with Your PM Tool: Video Demo | Linear Example&#x20;
{% endembed %}

{% hint style="info" %}
You can setup the workspace-wise integration as an "**Admin**" or a "**Owner**".
{% endhint %}

{% stepper %}
{% step %}

#### Open Workspace Settings > Integrations

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

{% step %}

#### 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.
{% endstep %}

{% step %}

#### Turn on workspace-wide integration&#x20;

Make sure that that the toggle is **ON** for "**All Projects**".&#x20;

{% hint style="warning" %}
By default, its turned on for workspace level integration.
{% endhint %}
{% endstep %}

{% step %}

#### Connect

Next, hit “**Connect**” at the top right.
{% endstep %}

{% step %}

#### Authorize BetterBugs.io <a href="#authorize-betterbugs.io" id="authorize-betterbugs.io"></a>

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

{% hint style="warning" %}
**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**.
  {% endhint %}
  {% endstep %}

{% step %}

#### 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**](/dashboard/workspace-settings/integrations/workspace-integration/workspace-automation.md).
  {% endstep %}

{% step %}

#### Optional: Select "Manually" and Connect

Finally, select "**Manually**" from the "**Forward Bug Reports**" dropdown and hit "**Connect**".
{% endstep %}
{% endstepper %}

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.&#x20;

{% hint style="success" %}
You can follow the same steps as above for integrating other tools.
{% endhint %}

### How to Disconnect Your PM Tool that's Integrated at the Workspace-level: Linear Example <a href="#steps-to-integrate-your-project-tool-at-the-workspace-level" id="steps-to-integrate-your-project-tool-at-the-workspace-level"></a>

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2Ffv8FQ9RfN8WNvLKP9I1a%2F04-Disconnect-Workspace-wide-Integration.mp4?alt=media&token=d2d48b96-936f-4ecc-b6cd-93433e06509f>" %}
Steps to Disconnect Your PM Tools that's Integrated at the Workspace Level in BetterBugs: Video Demo | Linear Example&#x20;
{% endembed %}

{% stepper %}
{% step %}

#### Open Workspace Settings > Integrations

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

{% step %}

#### Select your project tool <a href="#select-your-project-tool" id="select-your-project-tool"></a>

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).
{% endstep %}

{% step %}

#### Disconnect

Click on the “**Linear**” card and hit the “**Disconnect**” button at the bottom right.
{% endstep %}

{% step %}

#### Confirm action <a href="#authorize-betterbugs.io" id="authorize-betterbugs.io"></a>

To confirm action, click "**Disconnect**" from the modal.
{% endstep %}
{% endstepper %}

This instantly disconnects Linear app from your entire workspace.

### How to Exclude or Disconnect BetterBugs Project(s) from the Workspace Level Integration <a href="#steps-to-integrate-your-project-tool-at-the-workspace-level" id="steps-to-integrate-your-project-tool-at-the-workspace-level"></a>

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:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FIXYkQMAlBdYriDutLiCq%2F03-Disconnect-Specific-BetterBugs-Projects-from-Workspace-Wide-Integration.mp4?alt=media&token=c819eebc-5579-4425-a0b4-e040f83c67e0>" %}
Steps to Exclude BetterBugs Project(s) from the Workspace Level Integration: Video Demo | Linear Example
{% endembed %}

{% stepper %}
{% step %}

#### Open Workspace Settings > Integrations

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

{% step %}

#### Select your project tool integrated at the workspace level <a href="#select-your-project-tool" id="select-your-project-tool"></a>

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).
{% endstep %}

{% step %}

#### Open Linear card and turn off "All Projects"

Click on the “**Linear**” card. Next, toggle off "**All Projects**" and hit "**Continue**".&#x20;

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.
{% endstep %}

{% step %}

#### Select BetterBugs project to disconnect and click (⋮) under "Actions"  <a href="#authorize-betterbugs.io" id="authorize-betterbugs.io"></a>

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

{% step %}

### Disconnect

To confirm action, click "**Disconnect**" and "**Continue**".
{% endstep %}
{% endstepper %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.betterbugs.io/dashboard/workspace-settings/integrations/workspace-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.