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

# Repository settings

> Configure CodeRabbit's behavior for individual repositories using .coderabbit.yaml files or the web interface. Learn about configuration precedence and best practices.

## About repository settings

CodeRabbit provides three ways to manage its code-review behavior with each of your organization's repositories:

<CardGroup cols={3}>
  <Card title="Configuration file" icon="file-code">
    Add a `.coderabbit.yaml` file to your repository for version-controlled
    settings
  </Card>

  <Card title="Central configuration" icon="building">
    Apply organization-wide settings that inherit to all repositories
    automatically
  </Card>

  <Card title="Web interface" icon="browser">
    View or modify your per-repository settings using the CodeRabbit dashboard
  </Card>
</CardGroup>

## Configure your repository with `.coderabbit.yaml`

<Card title="Learn more about YAML configuration" icon="file-text" href="/getting-started/yaml-configuration" horizontal="true">
  Complete guide to adding and customizing configuration files
</Card>

## Browse and modify your settings using the web interface

To view or modify your repository settings using the CodeRabbit web interface:

<Steps>
  <Step title="Open repository settings">
    Visit [the CodeRabbit web
    interface](https://app.coderabbit.ai/settings/repositories) and click
    **Repositories** in the sidebar
  </Step>

  <Step title="Select repository">
    Click the gear-shaped **Settings** icon of the repository whose settings you
    want to view or modify
  </Step>

  <Step title="Configure inheritance">
    If the **Use Organization Settings** toggle is on, click it to turn it off
    to customize this repository's settings

    <Note>
      If you leave the toggle on, CodeRabbit applies settings from [the
      organization-configuration page](/guides/organization-settings) to this
      repository
    </Note>
  </Step>

  <Step title="Modify settings">
    Browse and modify your settings. The settings page opens in **Concise** mode
    by default, which shows the most commonly used settings. Click **Apply
    Changes** when you are finished.
  </Step>
</Steps>

### Settings view modes

The web interface provides three ways to view and edit your repository settings. All three modes read from the same underlying configuration, so changes persist when you switch between them.

* **Concise (default)**: A curated subset of the most commonly changed settings, organized into categories like General, Reviews, Pre-merge checks, and Finishing touches.
* **All Settings**: The complete list of every available setting. Switch to this mode if you need to access less common settings such as individual tool configurations, chat settings, knowledge base, code generation, and issue enrichment.
* **YAML Editor**: Direct YAML editing with syntax highlighting, real-time schema validation, and clipboard support. Only non-default values are shown. The YAML format matches `.coderabbit.yaml` for easy transfer between the web interface and repository files.

To switch modes, use the **Change mode** dropdown at the bottom of the sidebar.

<Tip>
  Use **Cmd+K** (Mac) or **Ctrl+K** (Windows/Linux) to open the command
  palette and search for any setting across all modes.
</Tip>

<Note>
  In YAML Editor mode, validation errors must be resolved before saving
  changes.
</Note>

### Preview

In Concise and All Settings modes, a live Preview panel appears on the right side of the settings page. This panel shows a mock PR review comment that visualizes how your settings affect the information CodeRabbit displays in pull request reviews.

<Frame caption="Concise mode with the Preview panel showing a live mock of how walkthrough settings affect the PR review comment">
  <img src="https://mintcdn.com/coderabbit/c_QO0Z4tCoZkPQxc/assets/images/settings-concise-preview.png?fit=max&auto=format&n=c_QO0Z4tCoZkPQxc&q=85&s=4056db4d3872672062c0a46282a7af70" alt="Concise mode with the Preview panel showing a live mock of how walkthrough settings affect the PR review comment" width="2556" height="1114" data-path="assets/images/settings-concise-preview.png" />
</Frame>

* Toggle the preview using the **Preview** button in the top-right corner. Preview is enabled by default.
* Settings that affect the PR review output are tagged with **Preview**, so you can identify which settings have a visible impact.
* When you change a setting with preview support, the preview panel automatically scrolls to the affected section and highlights the change.

The preview includes sections such as the PR summary, CodeRabbit-generated summary, walkthrough with changes table, sequence diagrams, pre-merge check results, and finishing touches.