# Source: https://graphite-58cc94ce.mintlify.dev/docs/linear.md

## Documentation Index

> Fetch the complete documentation index at: https://graphite-58cc94ce.mintlify.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

## Linear

> Learn how to integrate Graphite with Linear to view, link, and create issues associated with pull requests.

<img src="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/d9e64d62-1741191316-browser-window.png?fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=5bce2bc3ccb2652d0f15a46d13ae4b03" data-og-width="832" width="832" data-og-height="665" height="665" data-path="images/d9e64d62-1741191316-browser-window.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/d9e64d62-1741191316-browser-window.png?w=280&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=b1c578ed6a49db59b4fd971c92b64eb9 280w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/d9e64d62-1741191316-browser-window.png?w=560&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=d1b26dbc9afe29b301edf9339c8e4274 560w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/d9e64d62-1741191316-browser-window.png?w=840&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=87be022624c3363d9727fdd519bde8ca 840w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/d9e64d62-1741191316-browser-window.png?w=1100&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=6b2a5b2ef4953ae4676602a0249a49f1 1100w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/d9e64d62-1741191316-browser-window.png?w=1650&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=91c30efa18346888569deb2a3be6d5fe 1650w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/d9e64d62-1741191316-browser-window.png?w=2500&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=da5f650e75356df75d516a786a9cb7b9 2500w" />

With Graphite's Linear integration you can view, link, and create issues associated with pull requests right from the Graphite web app.

### Prerequisites

* A Linear account

## Connect Linear

Connect your Linear account directly from the [*Connected accounts* settings page](https://app.graphite.com/settings/connected-accounts) on the Graphite app.

<Frame caption="">
  <img src="https://mintcdn.com/graphite-58cc94ce/vY1t0Vsr-LRJgMIn/images/4c705623-1741213051-frame-10124206-1.png?fit=max&auto=format&n=vY1t0Vsr-LRJgMIn&q=85&s=87d7ee43435dd335a6cd61c6ec13c386" data-og-width="760" width="760" data-og-height="270" height="270" data-path="images/4c705623-1741213051-frame-10124206-1.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/graphite-58cc94ce/vY1t0Vsr-LRJgMIn/images/4c705623-1741213051-frame-10124206-1.png?w=280&fit=max&auto=format&n=vY1t0Vsr-LRJgMIn&q=85&s=7b0326f5656d6ec0088302f9b8ee4b11 280w, https://mintcdn.com/graphite-58cc94ce/vY1t0Vsr-LRJgMIn/images/4c705623-1741213051-frame-10124206-1.png?w=560&fit=max&auto=format&n=vY1t0Vsr-LRJgMIn&q=85&s=24e60e87ff31a4a66e352d137811b010 560w, https://mintcdn.com/graphite-58cc94ce/vY1t0Vsr-LRJgMIn/images/4c705623-1741213051-frame-10124206-1.png?w=840&fit=max&auto=format&n=vY1t0Vsr-LRJgMIn&q=85&s=feb3a575012f1a0c182a920b48bc5456 840w, https://mintcdn.com/graphite-58cc94ce/vY1t0Vsr-LRJgMIn/images/4c705623-1741213051-frame-10124206-1.png?w=1100&fit=max&auto=format&n=vY1t0Vsr-LRJgMIn&q=85&s=588752b28a8c90859f21bcfcdadb2a6c 1100w, https://mintcdn.com/graphite-58cc94ce/vY1t0Vsr-LRJgMIn/images/4c705623-1741213051-frame-10124206-1.png?w=1650&fit=max&auto=format&n=vY1t0Vsr-LRJgMIn&q=85&s=4d406d84584e659cf62a35f9a92d1321 1650w, https://mintcdn.com/graphite-58cc94ce/vY1t0Vsr-LRJgMIn/images/4c705623-1741213051-frame-10124206-1.png?w=2500&fit=max&auto=format&n=vY1t0Vsr-LRJgMIn&q=85&s=9ff2560efe49f7c4e030ac01dccf4c40 2500w" />
</Frame>

After clicking the `Connect` button you will be directed to Linear to finish the integration setup process.

<Frame caption="">
  <img src="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/b081be25-1741213061-frame-10124207-1.png?fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=9b7855bdff4813d6009eecb74ed16835" data-og-width="760" width="760" data-og-height="270" height="270" data-path="images/b081be25-1741213061-frame-10124207-1.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/b081be25-1741213061-frame-10124207-1.png?w=280&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=44e5054a186bcffe10b0ffb857e50fe8 280w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/b081be25-1741213061-frame-10124207-1.png?w=560&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=0578b805298fcdf09ffd2017bfc74684 560w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/b081be25-1741213061-frame-10124207-1.png?w=840&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=92b2c67a360726166f5cd0c2b2001665 840w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/b081be25-1741213061-frame-10124207-1.png?w=1100&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=c87d65efd8c1fed53da6cfe192f1f93c 1100w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/b081be25-1741213061-frame-10124207-1.png?w=1650&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=788950d014eaf494dfb6450749a5c8ee 1650w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/b081be25-1741213061-frame-10124207-1.png?w=2500&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=7385b968b6a392a6fe8e59fd7f780df9 2500w" />
</Frame>

Once the integration is successfully configured, you should see confirmation on the **Connected accounts** settings page.

## Using the Linear integration on the PR page

After you've installed the integration, you can will then be able to view any associated Linear issues in the sidebar of the **Pull Request** page.

<Frame caption="">
  <img src="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/eb0e2cd1-1741211170-frame-10123871.png?fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=ff754f55294cbf587c0fa89adcf71967" data-og-width="1304" width="1304" data-og-height="822" height="822" data-path="images/eb0e2cd1-1741211170-frame-10123871.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/eb0e2cd1-1741211170-frame-10123871.png?w=280&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=8f61f8e1a9c00b03ff5864e4889cbc0a 280w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/eb0e2cd1-1741211170-frame-10123871.png?w=560&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=b584c182efc3e709c6d9d224d50d2ed1 560w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/eb0e2cd1-1741211170-frame-10123871.png?w=840&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=018ca7a8474597916b01ebf4ed12278a 840w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/eb0e2cd1-1741211170-frame-10123871.png?w=1100&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=af8d31f69aa36d0e935c7f88773a3d42 1100w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/eb0e2cd1-1741211170-frame-10123871.png?w=1650&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=2d4e14607f9e3f7c9ddfbea11ac8c04b 1650w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/eb0e2cd1-1741211170-frame-10123871.png?w=2500&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=a7705282b71a96d4e30192a481d20d88 2500w" />
</Frame>

### Linking an existing issue

To link a Linear issue to a pull request, click the **+** symbol located in the issue tracker sidebar component.

<Frame caption="">
  <img src="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/83650d6a-1741211386-link-issue-popout.png?fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=8ba352d18dd62252c905a9fecdd7c660" data-og-width="1406" width="1406" data-og-height="1000" height="1000" data-path="images/83650d6a-1741211386-link-issue-popout.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/83650d6a-1741211386-link-issue-popout.png?w=280&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=ca1603c1f1e3a9aa18ece10f85945881 280w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/83650d6a-1741211386-link-issue-popout.png?w=560&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=24257ec19f0c9423c90605cb382db90b 560w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/83650d6a-1741211386-link-issue-popout.png?w=840&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=eb53cf3384ece231253205c8f7716f21 840w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/83650d6a-1741211386-link-issue-popout.png?w=1100&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=e1072aeb03ca726bf18cc07835786e17 1100w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/83650d6a-1741211386-link-issue-popout.png?w=1650&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=514633621aa6c0ca38db849c310267f3 1650w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/83650d6a-1741211386-link-issue-popout.png?w=2500&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=3ca2a07a2d19ae53e1e65af921e16bbd 2500w" />
</Frame>

From here you can:

* Search for a Linear Issue by name

* \[OR] Paste a Linear Issue URL

### Creating a new Linear Issue from PR page

To create and link a new Linear Issue from the Pull Request page, you can click `Create new issue` in the issue tracker sidebar component.

<Frame caption="">
  <img src="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/c3fa9d75-1741211806-create-modal-1.png?fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=3a1e55684fe6c1f02aedf5518aa89cf7" data-og-width="1648" width="1648" data-og-height="1000" height="1000" data-path="images/c3fa9d75-1741211806-create-modal-1.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/c3fa9d75-1741211806-create-modal-1.png?w=280&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=ebcf165c697f8551a918785a0c25c4da 280w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/c3fa9d75-1741211806-create-modal-1.png?w=560&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=fe86d9d1334cbeeda2b2828f5f81638b 560w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/c3fa9d75-1741211806-create-modal-1.png?w=840&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=df6427da0d41d1a5a80729e41bb1f3b9 840w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/c3fa9d75-1741211806-create-modal-1.png?w=1100&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=d833e6c2dd9d56bce73255681535bd64 1100w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/c3fa9d75-1741211806-create-modal-1.png?w=1650&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=1f9212b2b6bf300858a2e690df47928a 1650w, https://mintcdn.com/graphite-58cc94ce/v5snjlX4njZhFyeg/images/c3fa9d75-1741211806-create-modal-1.png?w=2500&fit=max&auto=format&n=v5snjlX4njZhFyeg&q=85&s=24e2d436ef19126e600dcd2761ad0787 2500w" />
</Frame>

From here you can assign a *Team, Title, Description, Status, and Priority*. Once you click `Create issue`. The issue will be created in Linear, and will be linked to the current pull request.