> For the complete documentation index, see [llms.txt](https://docs.betterbugs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.betterbugs.io/dashboard/workspace-settings/integrations/project-integration.md).

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