How to add attachments to issues in Linear

Learn how to attach files, images, videos and links to a Linear issue, so your team has the supporting material next to the work in one place.

Quick answer

Open the issue, then use the Attach images, files, or videos button under the description to add a file. To attach a link instead, open Issue options, choose Add link, paste the address into the URL field, and select Add link. The attachment then sits with the issue for your whole team.

Steps at a glance

  1. Open the issue you want to attach to
  2. Find the attach button under the description
  3. Open the Issue options menu
  4. Choose Add link
  5. Enter the URL of the link
  6. Select Add link to save it

Interactive demo

Loading demo…

Summary

Linear lets you keep supporting material on the issue itself. You can attach images, files and videos, or add a link to an outside page. Everything stays next to the work, so nobody hunts through chat for context.

Step-by-step guide

  1. Step 1

    Open the issue

    From the issue list, open the issue you want to add material to. The issue page shows the title, the description and the Activity feed below it.

  2. Step 2

    Find the attach control

    Look just under the description for the **Attach images, files, or videos** button. Use it to add screenshots, documents or recordings from your computer to the issue.

  3. Step 3

    Open the issue options menu

    To attach a web link instead of a file, select **Issue options** at the top of the issue. The menu also lists the attach shortcut next to the file option.

  4. Step 4

    Choose Add link

    In the menu, select **Add link…**. A dialog opens asking for the address you want to attach to the issue.

  5. Step 5

    Enter the link to attach

    Paste or type the address into the **URL** field. The **Title** field is optional, so add a short name if you want the link to read clearly on the issue.

  6. Step 6

    Add the link

    Select **Add link** to save it. The link now appears on the issue so anyone who opens it can follow it.

Why this matters

You are handing an issue to a teammate and the context lives in a screenshot, a recording and a reference page. Attaching them to the issue means the next person opens one place and has everything they need to start.

Frequently asked questions

  • Can I add a link without uploading a file?

    Yes. Open Issue options, choose Add link, enter the URL and select Add link.

  • Do I have to give the link a title?

    No. The Title field is marked optional, so you can leave it empty.

Related guides

Continue with more step-by-step guides for getting work done.

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

Start for free →