AtlasCustomer portalAPI DocumentationGo to Atlas
Help Center›Using Atlas (For Agents)›Ticket actions›How to link a ticket to a Linear issue
Table of contents
  • Overview
  • How to link a ticket to a Linear issue
  • Create a new Linear issue
  • Link an existing Linear issue
  • Unlink a Linear issue
  • FAQs & Troubleshooting
  • Why can't I find my team in the "Team" field?
  • Why didn't my ticket reopen when the Linear issue was completed?
  • Can I open the linked issue in Linear?

    • How to link a ticket to a Linear issue

    Last updated October 15, 2026

    Who can use this feature?
    Admins and Agents (not Viewers).

    Overview

    Linking a ticket to a Linear issue connects a customer's conversation in Atlas with the work your engineering team tracks in Linear. You can create a new issue from the ticket, start it from a Linear template, or link an issue that already exists.

    When a linked issue moves to a state your Admin selected, like Completed or Canceled, Atlas can reopen the ticket, so the customer gets a follow-up.

    Related articles:
    •  How to connect the Linear integration: Connect Linear and set up the webhook, teams and sync.
    •  How to link a ticket to a Jira issue: If your team tracks issues in Jira.
    •  How to snooze a ticket: Set a ticket aside while the linked issue is in progress.
    Requirements:
    The Linear integration must be connected in your workspace, including its webhook. To set it up, read How to connect the Linear integration.

    Create a new Linear issue

    1. In the "Inbox", open the ticket.
    2. In the ticket's side panel, click "Link issue".
    3. Optional: Click "Apply Linear template" and choose a template. Its description can include placeholders, like the customer's name and email.
    4. Fill in the issue fields:
    FieldWhat to enter
    TitleThe issue's title in Linear.
    TeamThe Linear team that owns the issue. Only monitored teams appear.
    AssigneeThe Linear user who will work on the issue.
    PriorityFor example, "Urgent" or "High".
    LabelsLabels to group related issues, for example "Feature".
    DescriptionFilled in by the template, if you applied one. Edit it if needed.
    • Click "Create issue". The message "Linked a new Linear issue [issue key] to ticket #[number]" confirms that the issue was created in Linear and linked to the ticket.

    The linked issue appears on the ticket. Click it to open the issue in Linear.

    1. Open the ticket and click "Link issue".
    2. Choose "Link".
    3. Search for and select the issue. The message "Linked Linear issue [issue key] to ticket #[number]" confirms the link.
    1. Open the ticket.
    2. Click the "X" next to the linked issue. The message "Unlinked Linear issue [issue key] from ticket #[number]" confirms it.

    FAQs & Troubleshooting

    Why can't I find my team in the "Team" field?

    Only the teams your Admin chose to monitor appear. Ask an Admin to add the team in the Linear integration settings.

    Why didn't my ticket reopen when the Linear issue was completed?

    Reopening depends on the integration settings: the webhook must be created in Linear, and the ticket's status and the issue's new state must be selected in the reopen settings. For details, read How to connect the Linear integration.

    Can I open the linked issue in Linear?

    Yes. Click the linked issue on the ticket. It opens in Linear.

    Was this article helpful?