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

# Customize the code review experience

> Customize the code review experience so it matches your team’s standards, workflows, and tolerance for noise.

You don’t need to configure everything to get value from Qodo. Most teams start with the defaults and selectively customize only what they need.

Configuration allows you to:

* Filter out noise from irrelevant pull requests
* Guide Qodo’s feedback to align with your team’s practices
* Maintain consistent review behavior across projects and repositories
* Improve the quality, relevance, and focus of review feedback

### What can be configured?

Qodo configuration allows you to control several aspects of the review experience:

#### How reviews run

* Which review commands are available
* Whether reviews run manually or automatically
* When reviews run (for example, on draft PRs, published PRs and additional commits)

#### How feedback appears

* Where comments appear (PR conversation summary or inline comments on file changes)
* Severity thresholds for inline feedback
* Control the number of surfaced findings

Qodo feedback is embedded directly within the Git provider experience and integrates with the provider’s native comment system. Available display options may vary depending on the provider’s capabilities.

#### What Qodo reviews

* Which repositories, branches, folders, or files are included
* Which pull requests should be ignored
* Which tickets or labels should be excluded

#### How Qodo behaves

* Custom instructions for review output
* Persistent review comments
* Feature-level behavior (for example, suggestion tracking or CI feedback)

### Supported configuration locations

Qodo settings can be defined at multiple levels, each corresponding to a different location. These settings can be configured using a `.pr_agent.toml` file or through the Qodo portal.

Supported locations:

* **Qodo portal** (Recommended) ([Configuration](/install-and-configure/configuration-overview/portal-configuration) page)
* **Repository Wiki** (`.pr_agent.toml`)
* **Repository Root** (`.pr_agent.toml`)
* **Organization settings repository** (`pr-agent-settings`)
* **Project settings repository** (`pr-agent-settings`)

<Note>
  **Enterprise** customers can configure environment-level settings.
</Note>

#### Configuration precedence

When settings are defined in more than one location, Qodo applies them in the following order (highest precedence first):

1. Repository Wiki (Wiki availability depends on the Git provider, as not all providers support a wiki feature).
2. Repository Root
3. Organization/ Project settings repository (`pr-agent-settings`)
4. Qodo portal (within this level, repository-level portal settings override organization-level portal defaults)

This hierarchy enables organizations to define shared defaults while still allowing repository-specific overrides when needed.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/configuration-precedence-light.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=9e5908a35d2d0b154fc858b28ee31c17" alt="Configuration precedence" width="1024" height="1132" data-path="images/code-review/configuration-precedence-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/configuration-precedence-dark.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=99aaebafc5df9adc22d67b7e3100fe8f" alt="Configuration precedence" width="1024" height="1132" data-path="images/code-review/configuration-precedence-dark.png" />
</Frame>

#### FAQ

<AccordionGroup>
  <Accordion title="Which settings take precedence if configuration exists in multiple locations?">
    Repository-level settings override both project-level and organization-level defaults.
  </Accordion>

  <Accordion title="What happens if both project-level and organization-level settings exist?">
    Project-level settings take precedence over organization-level settings.
  </Accordion>

  <Accordion title="How does Qodo locate the `pr-agent-settings` repository in GitLab subgroup structures?">
    For repositories nested within multiple subgroups, Qodo searches only **one level up** for a `pr-agent-settings` repository.
  </Accordion>

  <Accordion title="Do settings configured in the Qodo portal override repository configuration?">
    No. Settings defined in the Qodo portal have the lowest precedence and are overridden by repository, project, or organization-level configuration.
  </Accordion>

  <Accordion title="How do organization-level and repository-level portal settings interact?">
    Within the Qodo portal, repository-level settings override organization-level (workspace) defaults. This override applies only inside the portal: portal settings as a whole still have the lowest precedence and are overridden by repository, project, or organization-level configuration defined outside the portal.
  </Accordion>
</AccordionGroup>

### Supported configuration methods

You can select the configuration method that best fits your workflow:

* **Wiki configuration** (`.pr_agent.toml`) Does not require committing changes to the codebase. Changes take effect immediately.
* **Repository-level configuration** (`.pr_agent.toml`) Applies only to a specific repository. Requires committing a `.pr_agent.toml` file to the default branch.
* **Organization or project-level configuration** (`pr-agent-settings`) Defines defaults that apply across multiple repositories.
* **Portal configuration** (Qodo portal) Managed through the Qodo portal interface. These settings apply only when no configuration is defined in the repository wiki, repository root, or organization settings repository.

### Get started

Get detailed instructions on the configuration methods that suits your workflow:

* [Configure Qodo using the portal](/install-and-configure/configuration-overview/portal-configuration) (Recommended)
* [Configure Qodo using the .pr\_agent.toml file](/install-and-configure/configuration-overview/configuration-file)