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

# Comments

> The MainWP Comments Extension lets you approve, unapprove, mark comments as spam, move them to Trash, restore them, edit them, and permanently delete them across multiple Child Sites with bulk or individual actions.

## What You'll Learn

* How to manage comments across multiple sites
* Using bulk actions for comment moderation
* Approving, unapproving, spam marking, and deleting comments
* Customizing comment display settings
* Managing comments through the REST API and MainWP Abilities

***

> [!NOTE]
>
> **Extension Add-on** - This add-on provides standalone functionality within MainWP Dashboard. No third-party plugins required.

[Comments - Video Tutorial](https://www.youtube.com/embed/tCSX3z1KOOg)

The [MainWP Comments Extension](https://mainwp.com/add-on/comments/) lets you approve, unapprove, mark comments as spam, move them to Trash, restore them, edit them, and permanently delete them across your child sites from one place. You can use bulk actions to handle multiple comments at once or moderate them one by one.

## The Recent Comments Widget

A great addition to this add-on is the **Recent Comments** widget. It shows the latest Approved and Pending comments from your sites and provides quick links to moderate them or open the full comments page.

## Manage Comments

The MainWP Comments Extension allows you to manage comments on your websites. It lets you remotely

* Approve
* Unapprove
* Mark as Spam
* Not Spam
* Move to Trash
* Restore
* Edit
* Delete Permanently

On the **MainWP > Sites > Content Operations > Comments** page, you can find comments across your child sites and manage them without logging in to each site separately.

**1. Log in to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Content Operations > Comments page**

**3. Select the Child Sites you want**

**4. Use Select Status and Search Options to set your filters**

Use the sidebar filters to narrow your results:

1. **Select Status** lets you filter comments by Approved, Pending, Spam, or Trash
2. **Containing keyword** lets you find comments containing a specific word
3. **Date range** narrows comments by the selected dates

**5. Click the Show Comments button**

![MainWP Comments Add-on 2025](https://mintcdn.com/mainwp/2l_gbp8O-WEhKcrd/images/add-ons/comments-manage-list.jpg?fit=max\&auto=format\&n=2l_gbp8O-WEhKcrd\&q=85\&s=c1573dc7448e0604b1e966acdc5b790e) By default, the MainWP Dashboard plugin is set to return (show) a maximum of 50 comments from one Child Site.

### Review Bulk Moderation Results

With MainWP Child 6.3, comment moderation reports only changes completed by WordPress. A missing or invalid comment does not stop the remaining comments in a bulk action. Review the results and refresh the comment list before retrying any items that were not changed.

## Unapprove Comment

**1. Log in to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Content Operations > Comments page**

**3. Select the Child Sites you want**

**4. Use Select Status and Search Options to find the comments you need**

**5. Click the Show Comments button**

**6. Once the list of found comments appears**

Once the list of found comments appears

1. Locate the Comment you want to update
2. Click the **Unapprove** action in the Actions menu

The Unapprove action will appear only for comments that are already approved.

## Approve Comment

**1. Log in to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Content Operations > Comments page**

**3. Select the Child Sites you want**

**4. Use Select Status and Search Options to find the comments you need**

**5. Click the Show Comments button**

**6. Once the list of found comments appears**

Once the list of found comments appears

1. Locate the Comment you want to update
2. Click the **Approve** action in the actions menu

The Approve action will appear only for comments that are waiting for approval.

## Mark Comment as Spam

**1. Log in to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Content Operations > Comments page**

**3. Select the Child Sites you want**

**4. Use Select Status and Search Options to find the comments you need**

**5. Click the Show Comments button**

**6. Once the list of found comments appears**

Once the list of found comments appears

1. Locate the Comment you want to update
2. Click the **Spam** action in the actions menu

## Edit Comment

**1. Log in to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Content Operations > Comments page**

**3. Select the Child Sites you want**

**4. Use Select Status and Search Options to find the comments you need**

**5. Click the Show Comments button**

**6. Once the list of found comments appears**

Once the list of found comments appears

1. Locate the Comment you want to edit
2. Click the **Edit** action in the actions menu

## Move Comment to Trash

**1. Log in to your MainWP Dashboard**

**2. Go to the MainWP > Sites > Content Operations > Comments page**

**3. Select the Child Sites you want**

**4. Use Select Status and Search Options to find the comments you need**

**5. Click the Show Comments button**

**6. Once the list of found comments appears**

Once the list of found comments appears

1. Locate the Comment you want to trash
2. Click the **Trash** action in the actions menu

### Delete Comment Permanently

In the comments list, the **Delete Permanently** action is available for comments that are already in **Trash** or marked as **Spam**.

The comments table also includes **Restore** and **Not Spam** bulk actions. When a comment is in **Trash**, its row actions include **Restore** and **Not Spam**.

## Set Custom Comment Display Length

To set the custom comment length, please [see this gist.](https://gist.github.com/bogdan-mainwp/8fab61ca689f24aae74565f714ef00b6)

## Network Activity Logging

Comment moderation actions performed through the add-on (approve, unapprove, spam, unspam, trash, restore, delete) are recorded in [Network Activity](https://docs.mainwp.com/sites/network-activity.md) under the **Comments** connector. Use this to audit who moderated which comment and when, alongside the rest of your Dashboard activity.

Network Activity logging must be enabled in **MainWP menu (three lines, top right) > MainWP Settings > Network Activity Settings** (`/wp-admin/admin.php?page=SettingsInsights`) for these events to be stored.

## Manage Comments via the REST API

The Comments Extension exposes REST API v2 routes so you can list and moderate comments programmatically across your child sites.

| Method | Path | Purpose |
| - | - | - |
| GET | `/mainwp/v2/comments` | List comments across selected sites |
| GET | `/mainwp/v2/comments/{id_or_domain}` | List comments for one site |
| PUT, PATCH | `/mainwp/v2/comments/{id_or_domain}/{id_comment}/action` | Perform an action on one comment |
| PUT, PATCH | `/mainwp/v2/comments/{id_or_domain}/bulk-action` | Perform an action on multiple comments |

Supported actions: `approve`, `unapprove`, `spam`, `unspam`, `trash`, `restore`, `delete`.

Example — approve a comment on site `12`:

```bash theme={null}
curl -X PUT \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "action": "approve" }' \
  "https://your-dashboard.com/wp-json/mainwp/v2/comments/12/482/action"
```

From Comments 6.1.0, the REST routes require an API key whose user has the `manage_options` capability, or a Team Control user with assigned sites and access to the Comments extension. Other keys receive a 403. The `maximum` parameter accepts up to 100 comments per site, the all-sites list queries up to 100 sites per call, and invalid filter values return a 400.

See [Add-on Endpoints](https://docs.mainwp.com/api-reference/rest-api/extensions.md#comments) for the full parameter reference, paging headers, and additional examples.

## Manage Comments via MainWP Abilities

Comments 6.1.0 registers five MainWP abilities in the `mainwp-comments` category. Use them from scripts, AI assistants, or the [MainWP MCP server](https://docs.mainwp.com/mcp-server/overview.md) to list comments from your child sites, read one comment, read the recent comments saved at the last sync, moderate comments, and permanently delete trashed comments.

Moderation and deletion work on one site at a time. Each comment in the request names the status you expect it to have, and the child site skips any comment whose status has changed. Permanent deletion only applies to comments in Trash and requires a preview or an explicit confirmation.

The abilities require WordPress 6.9 or later on the MainWP Dashboard site and access to the Comments Add-on. Reading one comment, moderation, and deletion also require MainWP Child 6.2 or later on the target site. See [Comments Abilities](https://docs.mainwp.com/api-reference/abilities-api/comments.md) for request examples, response fields, and error handling.

***

## Related Resources

* [Administrative Add-ons](https://docs.mainwp.com/add-ons/administrative.md) - Browse administrative add-ons
* [Add-ons Overview](https://docs.mainwp.com/add-ons/overview.md) - All add-on categories
* [Add-on Endpoints](https://docs.mainwp.com/api-reference/rest-api/extensions.md#comments) - Comments REST API reference
* [Comments Abilities](https://docs.mainwp.com/api-reference/abilities-api/comments.md) - List, moderate, and delete comments through MainWP Abilities
* [Network Activity](https://docs.mainwp.com/sites/network-activity.md) - Review and configure activity logging


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