> ## Documentation Index
> Fetch the complete documentation index at: https://qodex.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Why did Qodex skip my PR?

> Understand the common policy, configuration, and GitHub webhook reasons Qodex may skip a pull request review.

# Why did Qodex skip my PR?

Qodex may receive a GitHub PR event and intentionally skip review.

Most skipped reviews are policy decisions, not platform failures. Common causes include draft PRs, non-reviewable GitHub actions, automatic reviews turned off, a plan limit, an unlinked repo, lost GitHub App access, or webhook signature failure.

## Check these first

| Reason | What it means | What to check |
| - | - | - |
| Non-reviewable action | The webhook action is not one Qodex reviews | Confirm the action is `opened`, `synchronize`, `reopened`, `ready_for_review`, a base-branch change, or `@qodex-ai review`. |
| Draft PR | Qodex waits for the PR to be ready | Mark the PR ready for review. |
| Automatic reviews off | The Check Run is titled "Review on request" | Ask with `@qodex-ai review` or **Run review**, or turn on **Automatic reviews** in the repo's review settings. Also check `pr_review.enabled` in `.qodex.yaml` on the PR branch. |
| Plan limit | The Check Run is titled "Qodex review skipped: plan limit" | The project used its included pull requests for the month, or this PR used every review its plan includes. The usage line on the PR review page shows the month's count. |
| Author or branch policy | The PR falls outside a configured `authors` or `base_branches` list | Check the repo's review settings or `.qodex.yaml`. |
| PR-level suppression | Automatic reviews were paused or the description declares `@qodex-ai ignore` | Run `@qodex-ai resume`, remove the declaration, or request a manual review. |
| Repo not linked | No Qodex project is mapped to the repo | Check **Settings > Connections > GitHub**. |
| App access lost | The GitHub App no longer has repo access | Reinstall the app or re-add the repo. |
| Signature failed | Webhook secret mismatch | Check server logs and `GITHUB_APP_WEBHOOK_SECRET`. |

## Where the reason appears

Open the PR's **Checks** tab.

Many intentional skips create a neutral Qodex Check Run with the reason in the title or summary.

In Qodex, open **Code > PR review**, then click the PR. Its **Review history** lists each review with what started it and, for most skipped reviews, the reason.

If there is no Check Run, check GitHub webhook deliveries and Qodex server logs. That usually means the event did not reach a linked project, or signature verification failed before Qodex could create a result.

## Why Qodex acknowledges skipped events

Qodex returns a successful webhook response for intentional skips so GitHub does not retry the same event.

The skip means "Qodex received this, but policy says not to review it."

## Next steps

> [card] [How a review fires](https://qodex.ai/docs/pr-review-how-it-fires.md)
>
> Follow the full review lifecycle.

> [card] [Troubleshooting PR review](https://qodex.ai/docs/pr-review-troubleshooting.md)
>
> Debug missing reviews.

> [card] [.qodex.yaml reference](https://qodex.ai/docs/qodex-yaml-reference.md)
>
> Check repo-level review settings.

> [card] [Connect a repo](https://qodex.ai/docs/pr-review-connect-repo.md)
>
> Confirm the repo is linked to a project.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.