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

# Tickets Tab

> Linear issue browser inside Triage — filter, search, and bulk-promote Linear tickets into BuildBetter projects

The Tickets tab lets you browse your Linear workspace from inside BuildBetter. Use it to bring Linear-tracked work into the BuildBetter projects flow — bulk-promote tickets, auto-attaching each to a new project.

## Filter Controls

The tab fetches Linear metadata on demand. Available filters:

* **Team** — every team in your Linear workspace
* **Project** — projects within the selected team
* **State** — issue states for the selected team
* **Assignee** — issue assignee

Free-text search routes through Linear's relevance search on the backend, so it understands the same query syntax Linear does.

## Issue Rows

Each row shows:

* **Identifier** — Linear-style ID (e.g., `ENG-123`)
* **Title**
* **State** — colored chip matching Linear
* **Priority**
* **Assignee** avatar
* **Updated at** — relative timestamp

Clicking a row opens the issue in Linear (new tab). There's no internal detail pane for tickets — Linear is the source of truth.

## Bulk Promote

The headline action. Select multiple Linear tickets, then click **Promote N**. The system:

1. Creates one tracked item per ticket
2. Auto-attaches the Linear ticket to the tracked item
3. Promotes the tracked item to `/projects`
4. Skips any ticket that's already linked to a project — surfacing a toast: *"Already linked to project X"*

This is the fastest way to backfill Linear work into BuildBetter projects — useful when you're onboarding a team that already lives in Linear.

## Filtering Out Already-Linked Tickets

The endpoint auto-filters tickets that already have a BuildBetter project link, so you won't see duplicates in the list. If you specifically want to re-link or re-promote, do it from the individual tracked item in the Signals tab.

<Tip>
  If a Linear ticket and a BuildBetter project share the same intent but were created separately, you can attach the ticket to the existing project from the project's [Integration Issues](../Projects/project-detail#integration-issues) card — no need to re-create the project.
</Tip>