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

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

## 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 it works

* 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 "Qodo updated to 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 review results** section in the comment, showing the history of past review runs. See [Previous review results](/code-review/comment-anatomy#previous-review-results-formerly-audit-trail) for how to read it.

<Frame>
  <img src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/pr-summary-comment-example.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=6877d41e7df2ddb1b1b759f52d47f2c0" alt="Persistent review comment updated with new findings marked with a star New label" width="869" height="691" data-path="images/code-review/pr-summary-comment-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.

## Enable persistent review comments using the Qodo portal (Recommended)

Navigate to **Configurations** > [**Code review**](/install-and-configure/configuration-overview/portal-configuration#code-review) and configure **Review every push** and **Persistent comment notification**. These settings apply to all connected repositories unless overridden at the repository level. See [Portal configuration](/install-and-configure/configuration-overview/portal-configuration).

## Enable persistent review comments using .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`             |

### 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 "Qodo updated to latest commit" message each time the comment is updated |
| `false`          | Suppresses the notification message                                              |

See [Configure using .pr\_agent.toml file](/install-and-configure/configuration-overview/configuration-file).