> For the complete documentation index, see [llms.txt](https://docs.bugbase.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bugbase.ai/integrations/linear.md).

# Linear

## Configuring Linear

#### Pre-requisites

* Linear Account with an Active Team
* BugBase Company Account with an Active Program

**Helpful Links**

{% content-ref url="/pages/9E9NQhwIg1plgHh2NFf5" %}
[Create a Company Account](/company-guide/create-a-company-account.md)
{% endcontent-ref %}

{% content-ref url="/pages/gt84QZChY5gJbxytLzR1" %}
[Programs at BugBase](/overview/programs-at-bugbase.md)
{% endcontent-ref %}

#### Setup

> Before starting the setup, ensure you are logged into your Linear Account and have atleast 1 team in your workspace.

<figure><img src="/files/QCCX8NNWqgjsBUdxvK09" alt=""><figcaption></figcaption></figure>

1. Navigate to the integrations tab located in the settings page of your BugBase Program. Alternatively you can use the following link: [`https://bugbase.in/company/settings/integrations`](https://bugbase.in/company/settings/integrations)
2. Click on the `Toggle Button` on the Linear Integration Card.
3. A popup asking to connect to your Linear account will appear. Click on the `Connect` button to proceed with the connection.
4. Once clicked, you will be redirected to the Linear authorization page where you would be requested access to your Linear workspace.

   <figure><img src="/files/hcpTmdaB8B82GkK4ukh2" alt=""><figcaption></figcaption></figure>
5. Click on the `Authorize` button to give access to BugBase to be able to enable the integration.
6. If everything went well, you will be redirected to the BugBase settings page and the Linear integration will be enabled.

#### Configuring the Linear Team, Status, Assignee & Auto-Create

> Before starting the configuration, ensure you have connected your Linear Account with your BugBase Account.

<figure><img src="/files/C4CNBhYxcY4mXHe0Qow0" alt=""><figcaption></figcaption></figure>

1. Navigate to the integrations tab located in the settings page of your BugBase Program.
2. Click on the `Configure` button on the Linear Integration Card.
3. A popup will appear where you can:
   * Select the **Team** where your reports should be created as issues.
   * Choose the **Linear status** created issues should be set to (for example `Backlog` or `Todo`). Leave it blank to use your team's default.
   * Choose a **Default assignee** for created issues, or leave it as `Unassigned`.
   * Toggle **Auto-create issue from reports** on or off, and pick the **BugBase status** that should trigger it.
4. Click on `Save` and the Linear Integration will be configured.

### Auto-Create

When **Auto-create issue from reports** is enabled, a Linear issue is created automatically in your selected team based on the trigger status you choose:

* **New (on report submission)** — an issue is created as soon as a report is submitted to your program.
* **Triaged** — an issue is created once a report has been triaged, so only validated reports reach Linear.

Every issue — whether created automatically or manually — is opened with the **status** and **assignee** you configured. If you prefer to keep control, leave auto-create disabled and create issues manually from any report whenever you need to.

{% hint style="success" %}
:tada: Congratulations! You've successfully connected **Linear** with your **BugBase Program**
{% endhint %}

### Up Next

{% content-ref url="/pages/Dg0pznxOSovxwglrGPC2" %}
[Creating a Linear Issue](/integrations/linear/creating-a-linear-issue.md)
{% endcontent-ref %}