> ## 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.
# TOML configuration and command reference
> An overview of the TOML configuration options available in Qodo v2.
Qodo v2 is designed to work out of the box, with minimal setup required. Teams can start receiving useful pull request feedback immediately, while configuration options allow you to fine-tune how reviews behave and how feedback appears in your workflow.
Configuration settings are defined in the repository's [`.pr_agent.toml`](/configuration/configuration-file) file and can also be applied at the organization level in the [Qodo portal](/configuration/portal-configuration). Learn more in [Customize the code review experience](/configuration).
The sections below describe the available configuration settings. For the commands and actions you can use directly in a pull request, see the [Pull request command and interaction reference](/code-review/pr-command-and-interaction-reference).
## Repository configuration options
Configuration is managed in the [`.pr_agent.toml`](/configuration/configuration-file) file.
### Review output and visibility
| Setting | TOML section | Description | Values |
| ------------------------------------------------------------------------ | ---------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`comments_location_policy`](/code-review/feedback-location) | `[review_agent]` | Controls where findings are posted in the pull request. | `summary` – all findings appear in a single summary comment
`inline` – findings are posted directly on relevant lines of code
`both` – a summary comment is posted and findings are also added inline (default) |
| [`inline_comments_severity_threshold`](/code-review/severity-thresholds) | `[review_agent]` | Determines which severity levels generate inline comments. | Unset (default) – no threshold applied
`3` – High
`2` – High and Medium
`1` – all findings |
### PR summary
| Setting | TOML section | Description | Values |
| -------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`publish_mode`](/code-review/comment-location) | `[qodo_describe_agent]` | Controls where the PR summary is posted. | `comment` – posts the summary as a standalone comment, separate from the pull request description (default)
`pr_description` – updates the PR body with User Description and AI Description headings
`dynamic` – posts a comment if the author already wrote a PR description, otherwise updates the PR body |
| [`publish_review_time_estimate_labels`](/code-review/pr-summary#publish-the-review-time-estimate-as-a-native-label-or-tag) | `[qodo_describe_agent]` | If set to `true`, applies the review time estimate as a native pull request label or tag. | `true` / `false` (default) |
### Findings display
Not supported on Bitbucket Data Center.
| Setting | TOML section | Description | Values |
| ------------------------------------------------------------------------------------------------------ | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`finding_overflow_count`](/code-review/findings-visibility) | `[review_agent_ux]` | Controls how many findings are shown before the rest collapse behind "View all". | `0` – all findings collapsed
`1`, `3` (default), `5` – number of findings shown before "View all"
`-1` – all findings expanded (portal: "All") |
| [`resolved_overflow_count`](/code-review/findings-visibility) | `[review_agent_ux]` | Controls how many resolved findings are shown before collapsing. | `0`, `1`, `3` (default), `5`, `-1` |
| `use_images_and_animations` | `[review_agent_ux]` | If set to `true`, shows Qodo's loading and empty-state illustrations and animations in review comments. | `true` (default) / `false` |
| [`show_context_used`](/code-review/comment-anatomy#code-review-findings-overview) | `[review_agent_ux]` | If set to `true`, shows the "Context sources" section in the code review summary comment. | `true` (default) / `false` |
| [`show_persistent_review_section`](/code-review/comment-anatomy#previous-reviews-formerly-audit-trail) | `[review_agent_ux]` | If set to `true`, shows the "Previous reviews" history section in the code review summary comment. | `true` (default) / `false` |
| [`show_daily_tips`](/configuration/display#comment-parts) | `[review_agent_ux]` | If set to `true`, shows the rotating "Tip of the day" section above the comment footer. | `true` (default) / `false` |
| [`show_dividers`](/configuration/display#comment-parts) | `[review_agent_ux]` | If set to `true`, shows divider lines between the parts of the review comment; when `false`, parts stay separated by a single blank line. | `true` (default) / `false` |
| [`show_comment_footer`](/configuration/display#comment-parts) | `[review_agent_ux]` | If set to `true`, shows the Qodo footer at the bottom of the review comment. | `true` (default) / `false` |
| [`severity_terminology`](/configuration/display#groups) | `[review_agent_ux]` | The vocabulary used for the three severity tiers in the review comment. | `high_medium_low` (default) / `critical_warning_informational` / `required_recommended_optional` / `p0_p1_p2` |
| [`findings_label_coloring`](/configuration/display#groups) | `[review_agent_ux]` | How group badges look in the review comment. | `simplified` (default, Qodo brand) / `color_scale` / `grayscale` |
### Expanded sections in findings
Not supported on Bitbucket Data Center.
| Setting | TOML section | Description | Values |
| ----------------------------------------------------------- | ------------------- | ---------------------------------------------------------------- | -------------------------- |
| [`expand_description`](/code-review/findings-visibility) | `[review_agent_ux]` | If set to `true`, expands the description section by default. | `true` (default) / `false` |
| [`expand_code`](/code-review/findings-visibility) | `[review_agent_ux]` | If set to `true`, expands the code section by default. | `true` / `false` (default) |
| [`expand_recommendation`](/code-review/findings-visibility) | `[review_agent_ux]` | If set to `true`, expands the recommendation section by default. | `true` / `false` (default) |
| [`expand_evidence`](/code-review/findings-visibility) | `[review_agent_ux]` | If set to `true`, expands the evidence section by default. | `true` / `false` (default) |
| [`expand_prompt`](/code-review/findings-visibility) | `[review_agent_ux]` | If set to `true`, expands the agent prompt section by default. | `true` / `false` (default) |
### Review workflow options
| Setting | TOML section | Description | Values |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| `pr_commands` | Git provider section (`[github_app]`, `[gitlab]`, `[bitbucket_app]`, `[bitbucket_server]`, `[azure_devops_server]`), or `[config]` as a fallback for providers that don't define their own | Commands run automatically when a PR is opened or updated. Remove a command to disable its trigger, for example remove `/agentic_review` to stop automatic code reviews. | [`/agentic_describe`](/code-review/pr-summary), [`/agentic_review`](/code-review/use-qodo-in-prs/code-review) |
| `feedback_on_draft_pr` | Git provider section (`[github_app]`, `[gitlab]`, `[azure_devops_server]`) | If set to `true`, also runs `pr_commands` when a PR is opened as a draft, instead of waiting until the PR is published. | `true` / `false` (default) |
| [`handle_push_trigger`](/code-review/persistent-review-comments) | Git provider section (`[github_app]`, `[gitlab]`, `[bitbucket_app]`, `[bitbucket_server]`, `[azure_devops_server]`) | If set to `true`, re-runs configured commands when new commits are pushed to the pull request. | `true` / `false` (default; `true` by default in `[azure_devops_server]`) |
| [`push_commands`](/code-review/persistent-review-comments) | Git provider section (`[github_app]`, `[gitlab]`, `[bitbucket_app]`, `[bitbucket_server]`, `[azure_devops_server]`) | Commands run automatically when new commits are pushed to the pull request. Requires `handle_push_trigger = true`. | [`/agentic_review`](/code-review/use-qodo-in-prs/code-review) |
| [`persistent_comment_notification`](/code-review/persistent-review-comments) | `[review_agent]` | If set to `true`, posts a "Qodo updated to latest commit" message each time the persistent review comment is updated. | `true` (default) / `false` |
| [`enable_incremental_review`](/code-review/persistent-review-comments#review-every-push) | `[review_agent]` | If set to `true`, a push-triggered re-review focuses only on changes since the last review instead of the whole pull request. | `true` (default) / `false` |
| `publish_in_progress_comment` | `[review_agent]` | If set to `true`, publishes a temporary "review in progress" comment while the review runs, then removes it once the review posts. | `true` (default) / `false` |
| [`publish_blast_radius_labels`](/code-review/assess-risk-with-blast-radius) | `[review_agent]` | If set to `true`, applies Qodo's code change risk classification as a native pull request label. | `true` / `false` (default) |
| [`demand_self_review`](/code-review/self-review) | `[review_agent]` | If set to `true`, a checkbox appears in the PR for the author to confirm they reviewed the findings. | `true` / `false` (default) |
| [`approve_pr_on_self_review`](/code-review/self-review) | `[review_agent]` | If set to `true`, adds Qodo as a reviewer after the author confirms self-review, allowing the PR to be merged. | `true` / `false` (default) |
| [`enable_chat_in_code_suggestions`](/code-review/auto-detected-questions) | `[pr_code_suggestions]` | If set to `true`, enables Qodo to automatically recognize and respond to questions written in PR comments. | `true` (default) / `false` |
| [`enable_cross_repo_agent`](/governance/cross-repo-code-review/repository-relationships#disable-cross-repo-context) | `[review_agent]` | If set to `true`, enables cross-repository code review. | `true` (default) / `false` |
| [`enabled`](/code-review/chat-with-qodo-in-your-pull-requests#disable-chat-with-qodo) | `[chat_agent]` | If set to `true`, enables the Qodo chat agent to answer questions and run commands on pull requests. | `true` (default) / `false` |
| [`enable_skills_agent`](/governance/manage-skills-across-repositories#enable-native-skills) | `[review_agent]` | If set to `true`, enables native skills to be applied during code review. | `true` / `false` (default) |
| [`enable_spec_agent`](/code-review/view-requirement-gaps-in-findings#set-using-pr_agent-toml) | `[review_agent]` | If set to `true`, extends requirement gap findings with Spec and PRD reviews. | `true` (default) / `false` |
| [`enable_ui_agent`](/code-review/view-ux-deviations-in-findings#set-using-pr_agent-toml) | `[review_agent]` | If set to `true`, compares Figma requirements against your front-end code. | `true` (default) / `false` |
| [`enable_web_search_tool`](/code-review/use-qodo-in-prs/third-party-dependencies-context#set-using-pr_agent-toml) | `[review_agent]` | If set to `true`, lets the review agent search the web for up-to-date documentation on third-party dependencies. | `true` / `false` (default) |
| [`override_effort`](/code-review/use-qodo-in-prs/control-review-effort#set-using-pr_agent-toml) | `[review_agent]` | Sets the review depth. Unset lets the router decide; any other value forces that depth directly. | Unset (default) – Auto
`lite` – Fast
`standard` – Balanced
`extended` – Deep |
| [`enable_review_md`](/governance/use-review-md#set-using-pr_agent-toml) | `[review_agent]` | If set to `true`, applies the repository's `REVIEW.md` instructions during code review. | `true` / `false` (default) |
### Custom review instructions
| Setting | TOML section | Description | Values |
| -------------------------------------------------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------- | ------ |
| [`issues_user_guidelines`](/code-review/extra-instructions) | `[review_agent]` | Extra instructions for the Issue finding agent, which handles bug, security, and performance detection. | string |
| [`compliance_user_guidelines`](/code-review/extra-instructions) | `[review_agent]` | Extra instructions for the Compliance agent, which handles rule checking. | string |
| [`smart_router_extra_instructions`](/code-review/extra-instructions) | `[review_agent]` | Extra instructions for the review effort agent, which decides how much review depth a pull request needs. | string |
### CI feedback options
GitHub
| Setting | TOML section | Description | Values |
| ------------------------------------------------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------- | -------------------------- |
| [`enable_auto_checks_feedback`](/code-review/enable-ci-failure-feedback) | `[checks]` | If set to `true`, automatically provides feedback when a CI check fails on a pull request. | `true` / `false` (default) |
| [`excluded_checks_list`](/code-review/enable-ci-failure-feedback) | `[checks]` | A list of CI checks to exclude from feedback. | `["check1", "check2"]` |
| [`persistent_comment`](/code-review/enable-ci-failure-feedback) | `[checks]` | If set to `true`, updates an existing CI feedback comment instead of posting a new one for each run. | `true` (default) / `false` |
| [`enable_help_text`](/code-review/enable-ci-failure-feedback) | `[checks]` | If set to `true`, displays a help message when a user comments `/checks` on a pull request. | `true` / `false` (default) |
| [`final_update_message`](/code-review/enable-ci-failure-feedback) | `[checks]` | If set to `true`, posts an additional message indicating the CI feedback was updated to the latest commit. | `true` / `false` (default) |
### Ignore rules
| Configuration key | TOML section | Description | Values |
| ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | -------------------------- |
| [`ignore_pr_title`](/code-review/ignore-content-from-analysis) | `[config]` | Ignores PRs with matching title patterns. | regex list |
| [`ignore_pr_source_branches`](/code-review/ignore-content-from-analysis) | `[config]` | Ignores PRs from matching source branches. | regex list |
| [`ignore_pr_target_branches`](/code-review/ignore-content-from-analysis) | `[config]` | Ignores PRs to matching target branches. | regex list |
| [`ignore_pr_labels`](/code-review/ignore-content-from-analysis) | `[config]` | Ignores PRs with specific labels. | label list |
| [`ignore_pr_authors`](/code-review/ignore-content-from-analysis) | `[config]` | Ignores PRs opened by specific users. | regex list |
| [`ignore_bot_pr`](/code-review/ignore-content-from-analysis#ignore-prs-opened-by-bots-and-ai-agents) | Git provider section (`[github_app]`, `[gitlab]`, `[bitbucket_app]`, `[bitbucket_server]`, `[azure_devops_server]`, `[gerrit]`) | Ignores PRs opened by bots and AI agents. | `true` (default) / `false` |
| [`ignore_repositories`](/code-review/ignore-content-from-analysis) | `[config]` | Excludes specific repositories from analysis. | regex list |
| [`allow_only_specific_folders`](/code-review/ignore-content-from-analysis) | `[config]` | Limits analysis to PRs that touch specific folders. | folder list |
| [`ignore_language_framework`](/code-review/ignore-content-from-analysis) | `[config]` | Excludes generated files by language/framework. | framework list |
| [`ignore_ticket_labels`](/code-review/ignore-content-from-analysis) | `[config]` | Ignores linked tickets with specific labels. | label list |
### Remediation
| Setting | TOML section | Description | Values |
| --------------------------------------------------------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| [`enable_fixer_agent`](/code-review/remediate-findings-in-prs) | `[chat_agent]` | If set to `true`, turns on the Remediation agent. | `true` / `false` (default) |
| [`enable`](/code-review/remediate-findings-in-prs) | `[fixer_agent]` | The flag the engine checks before running `/fix`. Computed automatically from `enable_fixer_agent` for portal-managed workspaces; must be set explicitly in a hand-written `.pr_agent.toml`. | `true` / `false` (default) |
| [`enable_auto_fix`](/code-review/remediate-findings-in-prs) | `[fixer_agent]` | If set to `true`, turns on Auto fix, automatically generating fixes for review findings. | `true` / `false` (default) |
| [`action_level_threshold`](/code-review/remediate-findings-in-prs) | `[fixer_agent]` | Minimum severity level the Remediation agent fixes. | `3` – High only (default)
`2` – High and Medium
`1` – all findings |
| [`open_new_pr`](/code-review/remediate-findings-in-prs) | `[fixer_agent]` | If set to `true`, delivers fixes in a separate pull request instead of pushing to the current branch. | `true` (default) / `false` |
| [`close_fix_pr`](/code-review/remediate-findings-in-prs) | `[fixer_agent]` | If set to `true`, closes the fix pull request once the fixing loop concludes. | `true` (default) / `false` |
| [`enable_commitable_suggestions`](/code-review/commitable-code-suggestions) | `[review_agent]` | If set to `true`, auto-attaches committable suggestions to eligible inline findings. | `true` / `false` (default) |
### Access control
| Setting | TOML section | Description | Values |
| ------------------ | ------------ | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| `invite_only_mode` | `[config]` | If set to `true`, only invited users receive Qodo's review feedback on their pull requests. Other users are silently skipped. | `true` / `false` (default) |