Skip to main content
Pre-merge checks are available in Preview for Pro plan users. During the Preview period, you can configure up to 5 custom checks per organization.
Agentic Pre-Merge Checks provide automated validation of pull requests against standard quality metrics and organization-specific requirements. Use Built-in Checks for common requirements and add your own Custom Checks with natural language instructions tailored to your teamā€™s policies. These AI-powered checks can be configured by an Admin user at the organization or repository level, and CodeRabbit automatically validates every pull request against these requirements.

ā€‹
Why use Pre-Merge Checks?

  • Consistent standards: Enforce naming, documentation, and change-management hygiene across every PR.
  • Safer merges: Catch breaking API changes, security gaps, or policy violations before they land.
  • Team-specific guardrails: Encode architectural patterns, compliance rules, or business logic as custom checks.
  • Faster reviews: Surface blocking issues early in the PR Walkthrough so reviewers can act quickly.

ā€‹
Built-in Checks

CodeRabbit includes four standard checks that address common organizational needs:

Docstring Coverage

Verify PR docstring coverage against a configurable threshold (80% by default)

Pull Request Title

Validate PR titles accurately reflect changes made and follow your specified requirements

Pull Request Description

Verify descriptions follow the template specified in your Git platform

Issue Assessment

Verify PRs address linked issues without containing out-of-scope changes

ā€‹
Custom Checks

Go beyond built-in checks by defining your own validation logic using natural language instructions. Custom checks leverage AI to understand and validate complex requirements specific to your teamā€™s policies, such as:
  • Detecting sensitive data in logs
  • Enforcing documentation for breaking changes
  • Validating database migration patterns
  • Ensuring compliance with language migration policies
Custom checks run in a secure, read-only sandbox and can access the PR diff, linked issues, and external context via MCP tools. Learn more about writing custom checks, including limitations and examples.

ā€‹
Configuring Pre-merge Checks

ā€‹
Enforcement Modes

Each check can be configured with one of three enforcement modes:
  • off: Check is disabled
  • warning: Display warnings but donā€™t block merges (default)
  • error: When paired with Request Changes Workflow, block merges until resolved or manually overridden
Start new checks in warning mode to gather feedback, then move to error mode once your team is aligned on expectations.

ā€‹
Configuration

Pre-Merge Checks can be configured via web interface or using .coderabbit.yaml file.
Configure Pre-Merge Checks through the CodeRabbit dashboard:
1

Navigate to Settings

In CodeRabbit, go to Settings ā†’ Review ā†’ Pre-Merge Checks (org or repo scope)
2

Configure Built-in Checks

Update configuration and enforcement modes for Built-in Checks
3

Add Custom Checks

Add Custom Checks:
  • Name (ā‰¤ 50 chars, unique within the org)
  • Instructions (ā‰¤ 1000 chars; natural language)
  • Mode (off | warning | error)
4

Apply Changes

Click Apply Changes to save. The new checks are applied to subsequent reviews.

ā€‹
Results in the Walkthrough

Pre-Merge Check results appear alongside CodeRabbitā€™s analysis in the PR Walkthrough with clear visual organization for quick assessment. Results are organized into two tables:
  • Failed checks ā€” prominently displayed to show errors and warnings requiring attention
  • Passed checks ā€” expandable to review checks that were validated successfully
Each check displays:
  • Objective ā€” the name of the check being evaluated
  • Status ā€” one of:
    • āŒ Error ā€” failed and will block merge when Request Changes is enabled
    • āš ļø Warning ā€” failed but non-blocking
    • āœ… Passed ā€” requirements met
    • ā“ Inconclusive ā€” incomplete instructions or insufficient information to decide
  • Explanation ā€” why the check passed or failed
  • Resolution ā€” what the author can do to remediate

ā€‹
Unblocking a PR

IfĀ Request Changes WorkflowĀ is enabled and a check inĀ ErrorĀ mode fails, the PR is blocked until the issue is resolvedĀ orĀ you explicitly ignore it. To ignore, select the Ignore failed checks checkbox in the PR Walkthrough. The PR is then unblocked and the affected rows are tagged [IGNORED] for traceability.
The override applies only to that PR. Future PRs will still enforce checks as configured.
You can restrict who can ignore failed checks by setting reviews.pre_merge_checks.override_requested_reviewers_only: true (default: false). When enabled, only requested reviewers (not the PR author) can use the checkbox or @coderabbitai ignore pre-merge checks, and CodeRabbit records who performed the override for auditability.

ā€‹
Manual commands

Trigger pre-merge checks manually using chat commands:

ā€‹
Run All Checks

@coderabbitai run pre-merge checks
This reruns all configured checks and updates results in the walkthrough.

ā€‹
Test Custom Check

@coderabbitai evaluate custom pre-merge check --name <check_name> --instructions <text> [--mode <error|warning>]
Tests custom check logic before saving to configuration.

ā€‹
Ignore failures

@coderabbitai ignore pre-merge checks
Manually ignore failed checks and unblock the PR.
See Manage code reviews for more commands and behaviors.