Linear Issue Not Closing When PR Is Merged
Workaround available Web, macOS, Windows Updated October 21, 2026
Quick answer
Usually caused by a non-closing magic word ('ref', 'part of'), another linked PR still open, or the team's merge automation set to no action. Use 'Fixes ENG-123' and check Settings > Team > Workflows & automations.
Most likely fix: Use a closing magic word.
Symptoms
The PR is merged on GitHub but the Linear issue stays In Progress or In Review instead of moving to Done.
Why it happens
- Non-closing magic word used (ref, refs, part of, contributes to)
- Several PRs linked and one is still open
- Merge automation set to 'no action' or pointing at a renamed/deleted status
- Branch-specific rule overrides the default for the target branch
- Squash merge from a branch whose earlier PRs were linked
How to fix it
Try these in order — the most common fix is first.
1. Use a closing magic word
- Edit the PR description
- Use close/fix/resolve/complete/implement before the ID, e.g. 'Fixes ENG-123'
2. Check every linked PR
- Open the issue and review all PR attachments
- Close or remove PRs that will never merge (three dots on the attachment > Remove)
3. Review team automations
- Go to Settings > Team > Workflows & automations > Pull request and commit automations
- Make sure 'merged' maps to an existing Done status
- Check branch-specific rules for main/staging
4. Relink after squash merges
- Add the issue IDs again to the final PR title or description
This guide also covers
- linear issue not moving to done
- linear pr merged status not updating
- linear github automation not working
Still not working?
If Linear keeps failing, you're not alone. See every Linear problem users report or the alternatives people switch to.
Other Linear errors
- Linear GitHub PR Not Linking to Issue
- Linear Ready for Merge Not Triggering
- Linear GitHub Integration Stopped Working
- Linear Notifications Not Working
- Linear Free Plan 250 Issue Limit Reached
- Linear Jira Import Missing Issues or Fields
- Linear Slack Links Not Unfurling
- Linear Not Loading or Stuck Syncing
- Linear Too Many GitHub PR Notifications