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

# How to configure PR review

> Monitor BattleTest review usage, switch between default-branch and all-branch coverage, and choose fallback behaviour when you hit your review limit.

PR review settings live in [Settings → Usage](https://battletest.dev/settings?tab=usage) and [Settings → PR Review](https://battletest.dev/settings?tab=pr-review). For the limit figures themselves, see [Limits & Quotas](/docs/reference/limits-and-quotas#pr-review-limits).

## Monitor your review usage

<Steps>
  <Step title="Open the Usage tab">
    Go to [Settings → Usage](https://battletest.dev/settings?tab=usage).
  </Step>

  <Step title="Read the meters">
    Each limit has a live meter showing current usage and when its window resets. Hourly windows reset on a rolling basis; the Free-plan monthly private-repo cap resets on the first of each UTC month. Reset times are shown in your local timezone.
  </Step>
</Steps>

## Change which branches get reviewed

By default, BattleTest only reviews PRs targeting your default branch.

<Steps>
  <Step title="Open branch filters">
    Go to [Settings → PR Review](https://battletest.dev/settings?tab=pr-review) → **Branch filters**.
  </Step>

  <Step title="Switch to all branches">
    Change from your default branch to **All branches**, then **Save**.
  </Step>
</Steps>

To also make the review a required gate on those branches, add GitHub branch protection rules — see [How to require security review before merging](/docs/how-to/require-security-review#require-review-on-all-branches).

## Choose what happens when you hit your limit

When your advanced review limit is reached, BattleTest applies your **overflow mode** rather than dropping the PR event:

* **Fallback** (default) — a [basic scan](/docs/concepts/how-pr-review-works#advanced-vs-basic-reviews) runs immediately, so every PR gets at least partial coverage. The PR comment notes that the basic scan ran.
* **Queue** — the advanced review is held and runs as soon as capacity recovers, preserving full analysis at the cost of a delay.

<Steps>
  <Step title="Open PR Review settings">
    Go to [Settings → PR Review](https://battletest.dev/settings?tab=pr-review).
  </Step>

  <Step title="Set the overflow mode">
    Choose **Fallback** or **Queue**, then **Save**.
  </Step>
</Steps>

If both the advanced limit and the basic fallback limit are exhausted in the same window, BattleTest posts a non-blocking GitHub check run with the reset time — no PR event is ever silently dropped, and running out of quota never blocks a merge.

## Configure notifications

See [How to configure notifications](/docs/how-to/configure-notifications).

## Upgrade when you regularly hit a limit

If you hit your hourly or monthly limit often, upgrade from [Settings → Billing](https://battletest.dev/settings?tab=billing). Paid plans have higher hourly limits and no monthly cap. See [How to manage your plan and billing](/docs/how-to/manage-plan-and-billing).