How to add external links to issues in Linear

Attach a web link to any Linear issue so specs, designs and references stay one click away. Follow six steps from the issue menu to the saved link.

Quick answer

Open the issue you want to update, then open the menu with Issue options and choose Add link…. Paste the address into the URL field, optionally give it a title, and select Add link. The link then appears on the issue under Resources, so everyone working on it can reach the reference quickly.

Steps at a glance

  1. Open the issue.
  2. Select Issue options.
  3. Choose Add link….
  4. Paste the address into URL.
  5. Optionally type a title.
  6. Select Add link to save.

Interactive demo

Loading demo…

Summary

Linear lets you attach external links directly to an issue, so the specs, designs and documents behind the work live next to it. The link is saved on the issue and shows up in its Resources section.

Step-by-step guide

  1. Step 1

    Open the issue menu

    Open the issue you want to attach a link to, such as ARC-4. Select **Issue options** in the header at the top of the issue to open its menu.

  2. Step 2

    Choose Add link

    In the menu, select **Add link…**. The menu also shows the shortcut next to it, so you can skip the menu next time.

  3. Step 3

    Paste the link URL

    A dialog titled for the issue opens with a **URL** field. Paste or type the full web address of the page you want to attach.

  4. Step 4

    Add an optional title

    Use the **Title(optional)** field to give the link a readable name, for example a short description of the page. Leave it empty if you do not need one.

  5. Step 5

    Save the link

    Select **Add link** to attach it to the issue. The dialog closes and the link is saved.

  6. Step 6

    See the link on the issue

    The link now appears in the **Resources** section on the issue, with the title you entered. Select it to open the page.

Why this matters

You are working an issue and the brief lives in a document outside Linear. Attaching the link means you and your teammates open the reference straight from the issue instead of hunting through chat threads and bookmarks.

Frequently asked questions

  • Is the title required?

    No. The Title(optional) field can be left empty.

  • Where does the link appear?

    On the issue, in the Resources section.

Create interactive demos like this one — free, no coding required.

Start for free →