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

# Enable persistent review comments

> Persistent review comments allow Qodo to update an existing review comment when new commits are pushed, instead of posting a new review each time.

Instead of posting a new comment for every push, Qodo keeps a single review comment up to date across a pull request's lifetime.

<Note>
  On this page, "persistent" refers only to the code review comment described in [How persistent review comments are updated](#how-persistent-review-comments-are-updated). It's unrelated to the PR summary's [Standalone comment](/code-review/comment-location) setting and to CI failure feedback's own [`persistent_comment`](/code-review/enable-ci-failure-feedback) setting, since each applies to a different comment.
</Note>

## Why use persistent review comments

Persistent review comments help teams:

* Keep pull request conversations clean
* Track progress across commits more easily
* Reduce noise during iterative reviews

## How persistent review comments are updated

* With every new commit, Qodo updates the existing review comment.
* If a new issue is introduced in a new commit, it appears as an additional finding marked with a ⭐️ **New** label.
* All findings are visible directly in the pull request code review.
* Qodo also posts a "Code review by qodo was updated up to the latest commit" message in the pull request each time it updates the comment. To disable this, see [Persistent comment notification](#persistent-comment-notification) below.
* Qodo keeps a **Previous reviews** section in the comment, showing the history of past review runs. See [Previous reviews](/code-review/comment-anatomy#previous-reviews-formerly-audit-trail) for how to read it.

<Frame>
  <img src="https://mintcdn.com/qodo/gIk7X1HVNy0JAf9g/images/code-review/persistent-comment-notification-example.png?fit=max&auto=format&n=gIk7X1HVNy0JAf9g&q=85&s=926c82acf6aa1126dc77d0a80c063711" alt="Qodo bot comment showing the persistent comment notification, &#x22;Code review by Qodo was updated up to the latest commit&#x22;" width="2171" height="724" data-path="images/code-review/persistent-comment-notification-example.png" />
</Frame>

To enable this behavior, push-trigger handling must be enabled in your repository configuration. You can enable it from the Qodo portal or using the `.pr_agent.toml` file.

## Configure persistent review comments in the Qodo portal (Recommended)

1. Log in to the Qodo portal.
2. Navigate to **Configurations** > **Workflow** > **Code review**.
3. Configure **Review every push**.
4. Navigate to **Configurations** > **Display** > **Notification comments**.
5. Configure **Persistent comment notification**.

These settings apply to all connected repositories unless overridden at the repository level. For more information, see [Configure Qodo using the portal](/configuration/portal-configuration).

## Configure persistent review comments in .pr\_agent.toml

### Review every push

Add the following inside your relevant git provider section in `.pr_agent.toml`. Do not include this in multiple provider sections.

Example (GitLab):

```toml theme={null}
[gitlab]
handle_push_trigger = true
push_commands = [
  "/agentic_review"
]
```

| Setting | Default | Behavior |
| - | - | - |
| `handle_push_trigger` | `false` | Re-runs configured commands when new commits are pushed to the pull request |
| `push_commands` | `["/agentic_review"]` | Commands run on each push, once `handle_push_trigger` is `true` |

The portal's **Review every push** toggle also sets `review_agent.enable_incremental_review`, which makes the re-run focus only on changes since the last review instead of reviewing the whole pull request again:

```toml theme={null}
[review_agent]
enable_incremental_review = true
```

| Value | Behavior |
| - | - |
| `true` (default) | Follow-up reviews focus only on changes since the last review |
| `false` | Every re-run reviews the full pull request again |

### Persistent comment notification

Set the following in the `[review_agent]` section:

```toml theme={null}
[review_agent]
persistent_comment_notification = true
```

| Value | Behavior |
| - | - |
| `true` (default) | Posts a "Code review by qodo was updated up to the latest commit" message each time the comment is updated |
| `false` | Suppresses the notification message |

For more information, see [Configure using .pr\_agent.toml file](/configuration/configuration-file).

## Related resources

* [Anatomy of a Qodo Code Review](/code-review/comment-anatomy#previous-reviews-formerly-audit-trail): How previous reviews appear in the review comment.
* [Track resolved findings in pull requests](/code-review/track-resolved-findings): Show resolved findings in place, in a separate section, or not at all.
* [Customize the code review experience](/configuration): What you can configure, and where to configure it.


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