# Project Integration

Use the “**Integrations**” tab within “**Workspace Settings**” to connect BetterBugs Project (individually) to your project management tools, issue trackers, communication software, and backend logger.

{% hint style="success" %}
You can also connect your project tool(s) at **Workspace Level** using workspace integration.
{% endhint %}

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

### Integrate Project Tools with BetterBugs.io: At the Project Level <a href="#integrate-project-tools-with-betterbugs.io-at-the-project-level" id="integrate-project-tools-with-betterbugs.io-at-the-project-level"></a>

You can integrate tools at the project level by navigating to **Workspace Settings > Integrations** from within your BetterBugs.io workspace.

{% hint style="info" %}
You can setup the project-wise integration as an "**Admin**" or a "**Member**". Project-wise integration enables you to setup one or more integrations for BetterBugs projects individually.
{% endhint %}

### How to Integrate Your Project Tools at the Project Level: Linear Example <a href="#how-to-integrate-your-project-tools-at-the-project-level" id="how-to-integrate-your-project-tools-at-the-project-level"></a>

Here are the steps to connect BetterBugs.io with your project tools at the project level:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FEQ2eWcKvm4guRoTERpaa%2F01-Integrate-BetterBugs-with-Linear.mp4?alt=media&token=963b69ea-8f95-41b4-aec8-a380068c7d5f>" %}
How to Integrate Linear with BetterBugs at Project Level: Video Demo
{% endembed %}

{% stepper %}
{% step %}

#### Open Workspace Settings > Integrations

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

{% step %}

#### Search Linear

In the **Integrations** tab, search for **Linear** and click to open the **Linear** card.
{% endstep %}

{% step %}

#### Turn off workspace-wide integration

Toggle off the "**All Projects**" option and hit "**Continue**". You should see the "**Manage per project**" option now.

{% hint style="info" %}
By default, its turned on for workspace level integration. For project-wise integration, you need to disable "**All Projects**".
{% endhint %}
{% endstep %}

{% step %}

#### Select a BetterBugs project to integrate and hit "Connect"

Select a project from the projects name list (that's within your Workspace). From the "**Actions**" column, hit "**Connect**" for that project.
{% endstep %}

{% step %}

#### **Authorize BetterBugs.io for Linear**

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

{% hint style="warning" %}
**IMPORTANT NOTE**&#x20;

If you're on a **free plan**, Steps 6 and 7 are **NOT REQUIRED**. **You can just SKIP** to "[*How to Create Bug Report on Linear using BetterBugs*](/product-features/integrations/linear.md#how-to-create-bug-report-on-linear-using-betterbugs)".

**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: Manually or Automatically

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 project integration steps.*
* **Automatically**: Enables you to [**create tickets with automation**](/dashboard/workspace-settings/integrations/project-integration/project-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 Project level integration for your Linear app. Now, you can create detailed reports and share them as Linear issues directly from your browser with a few clicks.

{% hint style="success" %}
You can follow the same steps to integrate other project tools.
{% endhint %}

### How to Disconnect Your Project Tool that's Integrated at the Project Level: Linear Example

Here're the steps to disconnect a BetterBugs project that's integrated with a project tool at the project level:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2Fo8L8QVi3qkYcxNG4ZizJ%2F04-Disconnect-BetterBugs-Project-from-Linear.mp4?alt=media&token=8bfa5fb0-c528-424f-9822-bec6c0bced82>" %}
How to Disconnect Your Project Tool that's Integrated at the Project Level: Video Demo | Linear Example
{% endembed %}

{% stepper %}
{% step %}

#### Open Project Settings

Use the **Gear Icon** beside the **BetterBugs Project** **Name** to open **Project Settings**.
{% endstep %}

{% step %}

#### Go to Workspace Settings > Integrations

Navigate to **Workspace Settings** > **Integrations**
{% endstep %}

{% step %}

#### Search Linear

In the **Integrations** tab, search for **Linear** and click to open the **Linear** card.
{% endstep %}

{% step %}

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

In the Linear card, select the BetterBugs project (from the Project list) to disconnect. For the project, click vertical dots (**⋮**) under the **Actions** column.
{% endstep %}

{% step %}

#### Disconnect and Confirm Action

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

This instantly disconnects Linear app from the selected BetterBugs project.


---

# 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/project-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.