Troubleshooting common issues
I cannot load a PR in demo mode
Possible causes:
- The PR is private
- The URL is invalid
- You hit demo rate limits
Fix:
- Use a public PR for demo
- Check URL format
- Sign in for private PR workflows
The queue is empty after setup
Possible causes:
- App is not connected to the expected repositories
- No open doc PRs match supported formats
Fix:
- Verify repository selection in org setup
- Open or update a doc PR in a connected repo
A magic-link reviewer submitted feedback, but nothing appears in GitHub
Cause:
- Feedback is pending and needs verify-and-push
Fix:
- Ask a GitHub-linked teammate to push pending feedback
I cannot sign off
Possible causes:
- Your role is below Maintainer
- Free plan active reviewer limit was reached
Fix:
- Ask an admin to adjust role or item permissions
- Upgrade plan or wait for next monthly period
External review link says expired or full
Cause:
- Link passed expiry date or max submissions
Fix:
- Create a new external review link for a new round
External reviewer says comments disappeared
Cause:
- Reviewer reopened a different link token, or link was revoked
Fix:
- Confirm link token
- Check if owner revoked link
- Use link dashboard to manage active links
A new commit landed, but state did not move to Addressed
Cause:
- Commit did not touch the commented region
Fix:
- Reopen review and verify changed regions
- Leave a follow-up comment with exact expected changes