Skip to content

Searching Linear for a duplicate engineering issue

Before opening a new Linear issue, the support rep translates the customer's wording into engineering-style symptom keywords and searches the most likely team's issues from the last sixty days. A strong match is recorded on the Zendesk ticket and skips the escalation, otherwise the support rep proceeds to create a new issue.

Category
Tags
linearsearchdeduplicationengineeringlabels
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

Read the confirmed bug summary and pick out the symptom in engineering language: error code, system component, action verb.

'Login broken' becomes 'SAML 401 cookie loop'. 'CSV export not working' becomes 'CSV export 500 large dataset'. 'Webhook missing' becomes 'webhook delivery 503 retry'. The translation is the work.

Expected: You have two to four symptom keywords ready to paste into Linear.

2

Linear

Open Linear's global search and paste the symptom keywords. Wrap any error code in double quotes so the search treats it as an exact match.

Without quotes, Linear's fuzzy matcher rewrites '401' across multiple issues and pollutes the result list. Quoted '"401"' will only match issues with that exact token.

Expected: The Linear search results are scoped to the most relevant issues for the symptom.

3

Linear

Filter the search by the engineering team most likely to own the area: ENG-PLAT for auth and infra, ENG-WEB for the dashboard UI, ENG-API for public API and webhooks, ENG-BILL for invoices and Stripe.

Most teams here own a clear surface area. If unsure, ENG-PLAT is the safest default to start with because they triage cross-team issues weekly.

Expected: Search results are scoped to the team most likely to own the bug.

4

Linear

Restrict to issues created in the last sixty days. Sort by relevance, then scan for a clear match in Backlog, Todo or In Progress.

Older issues that are still open are usually deprioritised work that is not coming back. Sticking to the last sixty days surfaces issues that engineering still considers active.

Expected: You have a manageable list of recent open issues to scan for a match.

5

Linear

Open any clear match and check its labels. If it carries 'support-blocking', leave a comment with the new Zendesk ticket number rather than re-escalating. If not, add 'support-blocking' yourself when you link.

An issue already labelled 'support-blocking' has been raised by support before. Repeating the escalation makes engineering tune out the label. Adding the label fresh is what tells engineering this is the second customer to hit the issue.

Expected: The match's labels reflect that support has linked a customer ticket to it.

6

Zendesk

If a match was found, copy the Linear issue identifier (e.g. ENG-PLAT-4192) and record it on the Zendesk ticket as 'Linear: ENG-PLAT-4192' in an internal note. If no match was found, proceed to escalate.

Use the issue identifier, not the URL. Identifiers are searchable across Zendesk and survive Linear URL changes.

Expected: The Zendesk ticket carries either the existing Linear identifier or a clear note that no duplicate was found and an escalation is the next step.

Supporting actions
Actions that provide evidence for this pattern.
Found ENG-PLAT-4192 'SAML 401 cookie loop' for Northwind, linked
No match in ENG-API for Eastview CSV 500, escalating new
Found ENG-API-3987 'webhook 503 retry' for Atlas Energy, In Progress
Added support-blocking label to ENG-PLAT-4192 for Sundermark
Searched ENG-WEB for 'permission denied dashboard', no match in 60d
Metadata
Timestamps and identifiers.
EvidenceObserved 56 times across 5 connections
ApplicationsLinear, Zendesk
First seen12 Feb 2026, 10:55
Last seen5 May 2026, 16:14
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