> ## 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.

# Set review strictness, tone and language

> Choose how many comments CodeRabbit posts with the review profile, then set the tone and language of its reviews.

Three settings shape how a CodeRabbit review reads. The review profile sets how much feedback you get. Tone instructions set how CodeRabbit words it. The language setting sets which language it writes in.

## Pick the right setting

| You want to change | Use | Where it lives |
| - | - | - |
| How many comments appear inline | Review profile (`reviews.profile`) | **Reviews > General** |
| How comments sound | Tone instructions (`tone_instructions`) | **General** |
| The language of reviews | Language (`language`) | **General** |
| What CodeRabbit checks in specific files | [Path instructions](https://docs.coderabbit.ai/pr-reviews/review-instructions.md) | **Reviews > General** |

Tone instructions change wording, not volume. To get fewer comments, change the profile.

## Choose a review profile

The profile has three values. `chill` is the default.

| Profile | What you get |
| - | - |
| `quiet` | Inline comments only for critical and major findings that are worth the effort to fix. CodeRabbit groups the rest in collapsed sections. |
| `chill` | Critical, major and minor findings inline, up to 20 comments. After that, CodeRabbit collapses minor findings first, then major ones. |
| `assertive` | Every severity inline, including trivial and informational findings. |

### How the profile affects tools

The profile is one switch for the whole review. For tools, it only chooses CodeRabbit's built-in fallback configuration for tools that have no configuration in your repository. Only `assertive` selects the stricter fallback rule sets. `chill` and `quiet` share the lighter one.

If your repository has its own tool configuration, CodeRabbit uses it, and the profile doesn't change it. PHPStan is the exception. If your PHPStan file doesn't set `level:` and `reviews.tools.phpstan.level` is `default`, the profile picks level 8 for `assertive` and level 3 otherwise. The profile also reports PHPStan findings as warnings under `assertive` and as errors otherwise. Use your tool's configuration for per-rule control. See [Review tools](https://docs.coderabbit.ai/tools/index.md).

## Set the tone of comments

Tone instructions are free text, up to 250 characters. They change how CodeRabbit phrases its comments, for example "Be concise and direct. Skip pleasantries."

## Set the review language

Set `language` to an ISO language code such as `de-DE` or `ja-JP`. The default is `en-US`. The full list of codes is in the [configuration reference](https://docs.coderabbit.ai/reference/configuration.md#param-language).

## Configure

> [tab] In the app
>
> Open **Review settings**, choose **Organization defaults** or a repository, and set **View mode** to **All Settings**.
>
> * **Profile:** go to **Reviews > General**.
> * **Tone instructions** and **Language:** go to **General**. They are not on **Reviews > General**.
>
> Select **Apply changes** and confirm to save.

> [tab] YAML V2
>
> ```yaml .coderabbit.yaml theme={null}
> language: "en-US"
> tone_instructions: "Be concise and direct."
> reviews:
>   profile: "chill"
> ```

> [tab] YAML V3
>
> Early Access (This feature is in early access. Enable it by setting `early_access: true` in your `.coderabbit.yaml`, or by toggling Early Access on the web interface.)
>
> V3 is a limited preview. Adding `version: 3` doesn't give your organization access.
>
> ```yaml .coderabbit.yaml theme={null}
> version: 3
> language: "en-US"
> fun:
>   tone_instructions: "Be concise and direct."
> reviews:
>   behavior:
>     profile: "chill"
> ```

> [!WARNING]
>
> Put each key at its own level. In V2, `language` and `tone_instructions` are top-level keys, and `profile` is under `reviews`. CodeRabbit drops a misplaced key and shows a warning about unrecognized properties in the review. V3 moves tone instructions to `fun` and the profile to `reviews.behavior`.

## Limits and availability

* All three settings work on every Git platform.
* A `tone_instructions` value longer than 250 characters isn't valid.
* A path instruction that matches every file, such as `**/*`, guides the review text only. The profile is what controls how many comments are collapsed.
* Schema V3 is a limited preview.

## Troubleshoot

* Too many comments: switch from `assertive` to `chill` or `quiet`, then see [Reduce review noise](https://docs.coderabbit.ai/configuration/guides/reduce-noise.md).
* A setting in the file has no effect: check that it sits at the right level, then run [Check which configuration a review used](https://docs.coderabbit.ai/configuration/guides/check-effective-configuration.md).

**All settings:** [`reviews.profile`](https://docs.coderabbit.ai/reference/configuration#param-reviews-profile), [`tone_instructions`](https://docs.coderabbit.ai/reference/configuration#param-tone-instructions) and [`language`](https://docs.coderabbit.ai/reference/configuration#param-language) in the configuration reference. V3: [`reviews.behavior.profile`](https://docs.coderabbit.ai/reference/configuration-v3#param-reviews-behavior-profile), [`fun.tone_instructions`](https://docs.coderabbit.ai/reference/configuration-v3#param-fun-tone-instructions).

## What's next

> [card] [Reduce review noise](https://docs.coderabbit.ai/configuration/guides/reduce-noise.md)
>
> Combine the profile, filters and instructions to cut comments.

> [card] [Teach CodeRabbit your review rules](https://docs.coderabbit.ai/pr-reviews/review-instructions.md)
>
> Add guidance for specific paths and rules.

> [card] [Review tools](https://docs.coderabbit.ai/tools/index.md)
>
> Configure the tools the profile affects.


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