Skip to content

Linking a Zendesk ticket to its Linear issue and setting the customer expectation

Once a Zendesk ticket has a Linear issue, the support rep records the Linear identifier as a 'linear-{id}' tag and sends a public reply chosen from one of three priority-keyed templates. The template is chosen by Linear priority and the Linear URL is never shared in the public reply.

Category
Tags
zendesklineartaggingtemplatesexpectation
What and why
The observed behaviour and the reasoning behind it.
Behaviour
Reasoning
Cause and effect
What initiates this pattern and what it produces.
Trigger
Outcome
Standard operating procedure
Step-by-step instructions to reproduce this pattern.
1

Zendesk

Open the ticket and add a tag in the format 'linear-{team}-{number}', lowercased and hyphenated (e.g. 'linear-eng-plat-4192').

Lowercase and hyphenated is the only format the post-fix sweep search recognises. Mixed case or underscores break the search and leave the customer hanging when the issue ships.

Expected: The ticket has a 'linear-{id}' tag in the canonical format.

2

Linear

Open the linked Linear issue and confirm its current priority. Note whether it is Urgent, High, Medium or Low.

The priority on the Linear issue (not the Zendesk ticket) is what determines which expectation template the customer receives. Engineering may have re-prioritised after escalation, so always check.

Expected: You know the current Linear priority and can pick the matching template.

3

Zendesk

Add an internal note on the Zendesk ticket of the form 'Linear: ENG-PLAT-4192 (priority: Urgent, status: Triage)'.

Keeping the Linear status in the internal note (not just the identifier) saves the next support rep a click. They can decide whether to give a fresh status update without leaving Zendesk.

Expected: The internal note records the Linear identifier, priority and status.

4

Zendesk

Pick the saved-reply template that matches the Linear priority: 'eng-active-update-daily' for Urgent, 'eng-logged-no-eta' for High and Medium, 'eng-backlog' for Low.

Resist the temptation to promise tighter timelines than the template offers. Customers remember promised ETAs and surface them weeks later when they slip.

Expected: The right template is loaded into the public reply.

5

Zendesk

Personalise the template with the customer's first name and the one-line summary of their report. Do not include the Linear identifier or URL.

The Linear identifier is internal. Customers who learn the identifier sometimes start asking for it by name later, which makes future sweeps and macro replies harder to keep tidy.

Expected: The reply addresses the customer by name and summarises their report in one line, with no internal identifiers visible.

6

Zendesk

Submit the reply as 'On-hold' so the ticket leaves the active queue without losing its Linear tag.

Submitting as Solved here is the most common mistake. Solved tickets get a CSAT survey straight away which is unfair to the customer when the bug is not actually fixed yet. On-hold preserves the linkage and pauses the SLA clock.

Expected: The ticket is on-hold with the public reply sent and the Linear tag still attached.

Supporting actions
Actions that provide evidence for this pattern.
Tagged Northwind #82441 'linear-eng-plat-4192', sent active-update template
Linked Eastview #82398 to ENG-API-4231, sent logged-no-eta template
Atlas Energy #82355 tagged linear-eng-api-3987, daily update set
Periwinkle #82287 tagged linear-eng-web-4233, backlog template
Heron #82321 tagged linear-eng-bill-4235, active-update sent
Metadata
Timestamps and identifiers.
EvidenceObserved 47 times across 5 connections
ApplicationsZendesk, Linear
First seen21 Feb 2026, 11:24
Last seen4 May 2026, 14:50
Questions

Frequently asked questions

Speak to the founder

Henry Denton, founder of FusedFrames

Get a demo. Watch a live capture, then an AI agent query the result.

Ask anything. Pricing, security or integrating with your stack.

No purchase obligation

Start capturing

Record in minutes. Install once and work as normal.

Plug AI agents in. One API call from any AI agent stack.

Refund on unused credits if you cancel