How Linear Issue Status Changes Sync Back to NOCK Tickets
Understand how Linear issue state changes sync to NOCK ticket statuses, how the status mapping works, and what your customers see in the portal.
Once the Linear integration is active, status changes you make in Linear automatically flow back to NOCK. This means your engineering team can keep working in Linear - moving issues through their normal workflow - while stakeholders and customers see an accurate, up-to-date status in NOCK and the Customer Portal without any manual updates on your part.
How sync works
When you move a Linear issue from one state to another - for example, from Todo to In Progress - Linear notifies NOCK of the change. NOCK then updates the status of the linked ticket to match. The update typically appears in NOCK within a few seconds of the change being made in Linear.
Note
Status sync is one-directional: changes made in Linear update NOCK. Changing a ticket status directly in NOCK does not push an update back to Linear.
Status mapping
Linear uses customisable workflow states, which NOCK maps to its own fixed set of statuses. The table below shows the default mapping.
| Linear state category | NOCK ticket status |
|---|---|
| Backlog | Backlog |
| Unstarted | Todo |
| Started | In Progress |
| Completed | Done |
| Cancelled | Cancelled |
Note
Linear allows teams to create custom state names (for example, Scoping, Code Review, Waiting on Customer). NOCK maps these to the closest status based on their underlying state category in Linear, not the display name. As long as you keep states in the correct Linear category, the mapping will work as expected.
Sync timing
Status updates are near real-time. In most cases the NOCK ticket status reflects the Linear issue state within seconds of the change. If you make several rapid status changes in Linear, NOCK will reflect the most recent state once it processes the updates.
Tip
If a status update seems delayed, wait a minute and then refresh the ticket in NOCK. Brief delays can occur during periods of high activity. If status is consistently not syncing, check the Troubleshooting page.
What customers see in the Customer Portal
Customers who have access to your NOCK Customer Portal see NOCK ticket statuses such as Backlog, Todo, In Progress, Done, Cancelled, or Duplicate. They never see your internal Linear state names, Linear links, or any other project-management detail. As your team works through issues in Linear, the Customer Portal updates automatically, giving customers confidence that their feedback is being acted on without requiring manual status updates from your team.