Skip to main content
PR review settings live in Settings → Usage and Settings → PR Review. For the limit figures themselves, see Limits & Quotas.

​
Monitor your review usage

1

Open the Usage tab

Go to Settings → Usage.
2

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.

​
Change which branches get reviewed

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

Open branch filters

Go to Settings → PR Review → Branch filters.
2

Switch to all branches

Change from your default branch to All branches, then Save.
To also make the review a required gate on those branches, add GitHub branch protection rules — see How to require security review before merging.

​
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 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.
1

Open PR Review settings

Go to Settings → PR Review.
2

Set the overflow mode

Choose Fallback or Queue, then Save.
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.

​
Upgrade when you regularly hit a limit

If you hit your hourly or monthly limit often, upgrade from Settings → Billing. Paid plans have higher hourly limits and no monthly cap. See How to manage your plan and billing.