Pick the right setting
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.
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. Onlyassertive 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.
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
Setlanguage 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.
Configure
- In the app
- YAML V2
- YAML V3
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.
Limits and availability
- All three settings work on every Git platform.
- A
tone_instructionsvalue 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
assertivetochillorquiet, then see Reduce review noise. - A setting in the file has no effect: check that it sits at the right level, then run Check which configuration a review used.
reviews.profile, tone_instructions and language in the configuration reference. V3: reviews.behavior.profile, fun.tone_instructions.
Whatâs next
Reduce review noise
Combine the profile, filters and instructions to cut comments.
Teach CodeRabbit your review rules
Add guidance for specific paths and rules.
Review tools
Configure the tools the profile affects.