> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qodo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate Qodo with Linear

> Linear is supported as an external ticketing integration and can be used with supported repository platforms by referencing tickets in the PR description or branch name.

## Linear app authentication

The recommended way to authenticate with Linear is by connecting the Linear app through the Qodo portal.

### Installation steps

<Steps>
  <Step title="Go to the Qodo Integrations page." />

  <Step title="Click Linear to connect the app." />

  <Step title="Complete the authentication flow to authorize Qodo to access your Linear workspace." />
</Steps>

Once connected, Qodo can fetch Linear ticket context for your pull requests.

### How to link a PR to a Linear ticket

Qodo will automatically detect Linear tickets using either of these methods:

**Method 1: Description reference:**

Include a ticket reference in your PR description using either:

* The full Linear ticket URL: `https://linear.app/<ORG_ID>/issue/<TICKET_ID>`
* The shortened ticket ID (for example, `ABC-123`) This method requires the `linear_base_url` configuration (see below).

**Method 2: Branch name detection:**

Prefix your branch name with the ticket ID, for example:

* `ABC-123-feature-description`
* `feature/ABC-123/feature-description`

### Linear base URL

To use shortened ticket IDs or branch name detection, configure your Linear base URL in your [configuration file](/code-review/get-started/configuration-overview/configuration-file) under the `[linear]` section.

```bash theme={null}
[linear]
linear_base_url = "https://linear.app/[ORG_ID]" # your Linear organization identifier
```