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

# Usage-based Add-on

> Enable pay-as-you-go billing to continue eligible PR reviews and CLI-triggered reviews after the applicable review limit is reached.

export const EssentialsPlanBadge = ({tip = "This feature is available on Essentials (formerly Pro), Team (formerly Pro+), Advanced, and Enterprise. Please refer to our pricing page for more information about our plans and features.", title = "Essentials Plan", cta = "Read more", href = "https://coderabbit.ai/pricing", disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="shield-check" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

export const AdminRoleBadge = ({tip = "This feature requires an organization owner, an admin role or the corresponding permission. Regular Members do not have access.", title = "Admin Only", cta = "View roles", href = "/management/roles", disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="lock" color="orange" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

<EssentialsPlanBadge tip="The usage-based add-on is available to eligible Essentials (formerly Pro), Team (formerly Pro+), and Advanced organizations." />

<AdminRoleBadge tip="This page requires an admin role or subscription management permission. Members do not have access to Usage-based add-on settings." />

The **Usage-based add-on** lets eligible Essentials, Team, and Advanced organizations continue processing PR reviews and CLI reviews after reaching the applicable review limit. Eligible PR overages are free during your [initial subscription trial](#pr-reviews-during-your-trial). After paid activation, reviews that continue beyond the applicable limit are billed at the usage-based rate. Manage pay-as-you-go billing, the continuation mode, and your spending cap from the **Usage-based add-on** tab in [Subscription and Billing](https://app.coderabbit.ai/settings/subscription).

<Info>
  The add-on is available to eligible Essentials, Team, and Advanced organizations. Free trial PR overages also include Enterprise trials. INR and marketplace subscriptions are excluded. After an Enterprise trial, your Enterprise agreement applies; contact your account team for paid usage-based billing options. The in-app activation option may not appear for organizations on certain billing arrangements; contact support if the pay-as-you-go toggle is unavailable. Your organization shares one pay-as-you-go billing path across all PR and CLI reviews.
</Info>

## Pricing

Outside the free trial PR overages described below, reviews that continue past your included limit are billed as pay-as-you-go usage and added to your monthly invoice.

| Metric                    | Value  |
| ------------------------- | ------ |
| Price per credit          | \$1.00 |
| Files reviewed per credit | 4      |
| Cost per reviewed file    | \$0.25 |

## PR reviews during your trial

Reviews beyond your plan’s rate limits are free during your initial subscription trial. When the first eligible PR review exceeds the limit, CodeRabbit enables usage-based reviews in **Automatic** mode and completes that same review for \$0. An existing **Off** or **On demand** choice is preserved.

Each completed trial overage includes a PR notice explaining that the review exceeded the plan’s limits and was free during the trial. Billing shows the waived amount, such as \*\*$12.00 waived during your trial.** Trial overages are charged at $0.00 and do not count toward your spending cap.

When your trial ends, you can choose whether to keep usage-based reviews enabled or opt out. Before disabling, billing shows how many review events continued beyond your plan’s limits during the trial, or in the last 30 days after the trial. Turning it off means future over-limit reviews pause. Reviews already completed during the trial remain free, and re-enabling during an eligible trial restores free PR overages.

Your saved continuation choice carries over when you activate a paid subscription. If you keep **Automatic** enabled, subsequent over-limit reviews use the paid rate. Enterprise billing follows your agreement. The free overage period ends when your trial ends, even if you do not activate a paid subscription.

This trial benefit covers PR review rate-limit overages. It does not change CLI/IDE pricing or usage-priced large PR reviews, and it does not apply to additional trials granted to an already-paid subscription.

## PR review behavior

After the included review limit is reached, an admin chooses what happens next with the **After included review limits** setting in the **Usage-based add-on** tab. This review continuation mode has three options:

| Mode          | Behavior after the included limit is reached                                                                                                                |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Automatic** | CodeRabbit continues every eligible review automatically. Eligible trial PR overages are free; other overages are billed. Developers are not interrupted.   |
| **On demand** | Reviews pause at the limit. An assigned-seat developer explicitly authorizes each review to use usage credits. See [On demand reviews](#on-demand-reviews). |
| **Off**       | Reviews stop when the included limit is reached. Developers wait for included reviews to reset, or an admin changes the mode.                               |

### On demand reviews

In **On demand** mode, CodeRabbit pauses at the included limit and shows the number of billable files and the maximum price before any paid work starts. An assigned-seat developer confirms the charge to continue:

* **GitHub** — check the **Review with credits** box in the PR review summary, or comment `@coderabbitai review --use-credits`.
* **GitLab, Bitbucket, and Azure DevOps** — comment `@coderabbitai review --use-credits`. These providers do not have the interactive checkbox.
* **CLI** — re-run the review with `coderabbit review --use-credits`. See [Usage-based reviews and consent](/cli/index#usage-based-reviews-and-consent).
* **VS Code** — choose **Review with credits**.

Consent applies only to the current review content. It is bound to the pull request's current commit, so if the content changes or a new review starts, CodeRabbit asks for confirmation again. A generic review, retry, or force-review command never authorizes a paid on demand review on its own. Only developers with an assigned seat can authorize on demand reviews; other developers are asked to have an admin assign a seat or change the continuation mode.

After a usage-based review completes, CodeRabbit posts a **Usage-based review receipt** with the mode, the number of reviewed files, and the amount charged, plus a link to usage details in the billing tab.

### Large pull requests

File limits per review are separate from the rolling review limits. See [Plans and pricing](/management/plans#rate-limits) for the included file limit for each plan.

When an eligible GitHub pull request exceeds the included file limit but contains no more than 300 files, CodeRabbit skips the automatic review and can display a **Review on demand using usage pricing** action. Selecting the action explicitly authorizes the review to use the usage-based billing path. Generic retry and manual review commands do not authorize usage pricing for a large pull request.

The review proceeds only when usage-based reviews are enabled and sufficient remaining spending capacity is available. Pull requests with more than 300 files cannot be reviewed through this action. Other Git providers show the file-limit message without the interactive usage-priced action.

CLI-triggered reviews follow the same billing path and opt-in logic as reviews from GitHub, GitLab, Bitbucket, and Azure DevOps PR pages. Authenticated CLI and agentic API-key reviews use the assigned user's plan allowance first. Usage is billed only after the review reaches the applicable limit and the request is attributed to a user with an assigned seat.

For Essentials, Team, and Advanced PR reviews, your plan includes a per-developer hourly allowance. Developers with typical PR review activity continue to see reviews become available normally for their plan. When one developer identity reaches the 95th percentile or higher of recent CodeRabbit PR review usage, CodeRabbit gradually spaces out additional reviews for that developer. Your plan allowance is not changed. To learn more, see our [Fair Usage Limits Policy](/management/rate-limits#fair-usage-limits-policy).

If high volume is not intentional, check [Review Usage](/management/review-usage-dashboard) first to see which pull requests and developers are consuming the allowance, then tune [automatic review controls](/configuration/auto-review) before relying on pay-as-you-go usage: pause automatic incremental reviews after 1 or 2 reviewed commits, turn off automatic reviews and add a configured ready-for-review label to opt PRs in, use title exclusions for WIP or generated changes, or request reviews manually for noisy repositories. Use pay-as-you-go when the extra throughput is intentional and you want eligible over-limit reviews to continue without waiting for the next included review.

### Enable the add-on

Admins manage usage-based reviews from the **Usage-based add-on** tab in [Organization Settings](https://app.coderabbit.ai/settings/subscription?tab=usage). Turn on pay-as-you-go file reviews, then set **After included review limits** to **Automatic**, **On demand**, or **Off** to choose the [review continuation mode](#pr-review-behavior). There is one pay-as-you-go billing path covering all PR and CLI reviews.

A valid payment method is required before enabling paid metered usage. Without one, CodeRabbit rejects paid activation before billing begins. Free trial PR overages do not require a payment method.

### Manage the add-on

<Steps>
  <Step title="Open the Usage-based add-on tab">
    Go to **[Subscription and Billing](https://app.coderabbit.ai/settings/subscription)** in your organization settings, then open the **Usage-based add-on** tab.
  </Step>

  <Step title="Turn on pay-as-you-go and choose a continuation mode">
    Enable **Pay as you go file reviews**, then set **After included review limits** to **Automatic**, **On demand**, or **Off**. See [PR review behavior](#pr-review-behavior) for what each mode does.
  </Step>

  <Step title="Set a monthly spending cap">
    Choose a monthly spending cap, or select **Unlimited**. New reviews over the included limit stop once the cap is reached, then resume after an admin raises the cap or the monthly period resets; reviews already in progress can finish. See [pricing](#pricing) for per-file rates. Paid usage is added to your monthly invoice. Free trial PR overages do not count toward the cap.
  </Step>

  <Step title="Review usage">
    Track files reviewed, the amount used against your cap, and recent usage events in the same tab.
  </Step>
</Steps>

## What's next

<CardGroup cols={1}>
  <Card title="Plans and pricing" href="/management/plans" icon="credit-card" horizontal>
    Compare CodeRabbit plans and understand per-developer rate limits
  </Card>

  <Card title="Billing and plans" href="/management/billing" icon="receipt" horizontal>
    View invoices, change your subscription plan, and adjust seat counts
  </Card>
</CardGroup>