Linear

export const meta = { title: 'Linear integration', description: 'Connect Linear to Canary so you can search and reference tickets directly from Slack assistant threads and use issue context during QA work.', tags: ['integration', 'linear', 'slack'], };

Connect Linear to Canary so your team can find and reference Linear issues without leaving Slack assistant threads. Use the integration to bring ticket context into release QA conversations and move faster when you need to confirm status, ownership, or recent issue details.

01Prerequisites

Before you connect Linear, make sure you have the following:

A Canary workspace with access to integrations
A Linear workspace you want Canary to search
Permission to authorize apps in Linear
Access to the Slack assistant threads where you plan to use ticket lookup

If you use Canary in Slack today, make sure your Slack assistant setup is already working before you add Linear. For broader Slack workflows, see /docs/integration/slack.

02Connect Linear

Connect Linear from Canary settings so Slack assistant threads can search your Linear workspace.

Open Canary.
Go to Settings.
Open Integrations.
Select Linear.
Click Connect Linear.
Sign in to Linear if prompted.
Review the requested access.
Click Authorize.
Return to Canary and confirm the connection is active.

After you connect the integration, Canary can use your authorized Linear access to look up tickets from supported Slack assistant threads.

Linear integration settings

03Configure access and permissions

After you connect Linear, review who can use the integration and what data Canary can search. Keep access limited to the teams and workspaces that need ticket context in Slack.

Use this table to review the main access areas:

Setting	What it controls
Connection status	Shows whether the Linear account is connected and available to Canary
Authorized workspace	Identifies which Linear workspace Canary searches
Slack assistant usage	Determines where users can search and reference Linear tickets from Slack assistant threads
Reconnect or disconnect	Lets you refresh access or remove the integration if permissions change

If your team uses multiple issue trackers, you can also pair this setup with Jira lookup in Slack assistant threads. See /docs/integration/jira.

04Use Linear in Canary

Once connected, use Linear anywhere Canary supports issue lookup in Slack assistant conversations. This helps you answer release and QA questions with current issue details in the same thread.

Search and reference tickets from Slack assistant threads

Use the Slack assistant when you need to find a specific Linear issue or ask about work related to a bug, task, or release question.

Open a Slack assistant thread in a connected workspace.
Ask the assistant to find a Linear ticket by key, title, or related topic.
Review the returned ticket details in the thread.
Continue the conversation with follow-up questions to clarify status, ownership, or related work.

Search works best when you include the ticket key if you know it. If you do not know the exact issue, use a short description or feature name to help narrow the results.

Common ways to ask include:

Find Linear ticket ENG-123
Search Linear for login timeout issue
What Linear issue tracks the onboarding modal bug?
Show the Linear ticket for the release blocker in checkout

Use Linear context in QA workflows

Use Linear issue context to keep release QA conversations grounded in the latest known work. This is especially useful when triaging failures, checking whether a bug is already tracked, or linking test outcomes to active issues.

You can use Linear context in QA workflows to:

Confirm whether a failed behavior is already tracked in Linear
Check ticket ownership before handing off a bug
Reference issue details while discussing a run in Slack
Speed up ad-hoc investigation when you need issue context alongside test results

For adjacent QA workflows, see /docs/guide/ad-hoc-tests and /docs/guide/runs.

05Troubleshooting

If Linear results do not appear in Slack assistant threads, use these checks:

Confirm the Linear integration shows as connected in Settings > Integrations.
Confirm you authorized the correct Linear workspace.
Confirm you are using the Slack assistant in a workspace where Canary is available.
Try searching with the exact Linear ticket key, such as ENG-123.
Reconnect Linear if your permissions or workspace access changed.

If the integration connected successfully but search results still seem incomplete, try a more specific query with the issue key or a distinctive title phrase.

/docs/integration/slack
/docs/integration/jira
/docs/guide/ad-hoc-tests
/docs/guide/runs