---
title: "Rocket Chat Message Auditor Guide"
slug: "message-auditor"
description: "Learn how to use the message auditor in Rocket Chat. Ensure secure communications, compliance, and governance."
tags: ["Enterprise"]
status: "update"
updated: 2026-05-18T20:28:21Z
published: 2026-05-18T23:04:09Z
canonical: "docs.rocket.chat/message-auditor"
stale: true
---

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

# Message Auditor

![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Premium(1).svg)

Rocket.Chat's **Message Auditor** feature allows authorized users to audit messages and read conversations across a workspace. This can help organizations monitor internal communication and ensure appropriate behavior, especially in customer-facing scenarios.

To access the **Audit Messages Panel**, a user must:

- Have the `auditor` [role](https://docs.rocket.chat/v1/docs/roles-in-rocketchat).
- Or be granted the `Can Audit` [permission](https://docs.rocket.chat/v1/docs/permissions).

### What can an Auditor do?

Auditors have the ability to:

- Review messages in private rooms.
- Review messages by specific users.
- Review direct messages between users.
- Inspect [omnichannel](https://docs.rocket.chat/v1/docs/omnichannel) conversations (e.g., customer support).
- Check audit history using the [Message Audit Logs](https://docs.rocket.chat/v1/docs/audit-logs).

### Accessing the Audit Messages panel

To access the panel:

1. Go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) > **Audit** > **Messages**.
2. Use the available tabs:
  - **Rooms**: Search messages by channel.
  - **Users**: Search messages by user.
  - **Direct Messages**: Review private conversations.
  - **Omnichannel**: View [customer-agent interactions](https://docs.rocket.chat/docs/omnichannel-users#omnichannel-agents).

> [!NOTE]
> If you cannot access the panel, contact your workspace administrator to [assign message auditing permissions](https://docs.rocket.chat/v1/docs/message-auditor#assign-auditing-permissions) to your account.

## Search and review messages

You can search and filter messages using various fields:

- **Message**: Enter keywords to filter content (leave blank to see all messages).
- **Date range**: Set a custom start/end date or choose from presets like *Today*, *Last Week*, etc.
- **Channel Name**: Enter the name of a specific room or channel.
- **Export PDF**: Click to export filtered messages as a PDF document.

### Searching by rooms/channel

To search for a specific message in a channel or room:

- Enter a keyword or phrase in the **Message** field. Leave it empty to retrieve all messages.
- Set the **start** and **end** dates to narrow results to a specific time period. Use the **⋮** (three-dots icon) to select preset ranges like *Today, Last Week*, etc.
- Select the channel or room from the **Channel Name** drop-down menu.
- Click **Apply** to display the filtered messages.
- (Optional) Click **Export PDF** to download the results.

### Searching by users or direct messages

To search for messages sent by specific users:

- Enter keywords or phrase in the **Message** field. Leave it empty to retrieve all messages.
- Set the **start** and **end** dates to narrow results to a specific time period. Use the **⋮** (three-dots icon) to select preset ranges like *Today, Last Week*, etc.
- In the **Users** field, type and select one or more users from the list.
- Click **Apply** to display messages from the selected users that match the search criteria.
- (Optional) Click **Export PDF** to download the results.

### Searching by Omnichannel

Use the Omnichannel tab to search for conversations between agents and visitors:

- Enter keywords or phrases in the **Message** field. Leave it empty to retrieve all messages.
- Set the **start** and **end** dates to narrow results to a specific time period. Use the **⋮** (three-dots icon) to select preset ranges like *Today*, *Last Week*, etc.
- In the **Visitor** field, enter the name of the contact or visitor.
- In the **Agent** field, enter the name of the agent who handled the conversation.
- Click **Apply** to view the matching Omnichannel conversations.
- (Optional) Click **Export PDF** to download the results.

## Assign auditing permissions

To access the **Audit Messages** feature, users must have the `auditor` role with the appropriate auditing permission. To assign this role to a user,

1. Go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) > **Workspace** > **Users**.
2. Select the user you want to edit and click **Edit** on the side panel that opens.
3. Scroll down to find the **Roles** setting for the user.
4. Select the `auditor` role from the drop-down menu.
5. Click **Save user**.

Alternatively, as a workspace administrator, you can assign the **Can Audit** permission. To assign message auditing permissions:

1. Go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) > **Workspace** > **Permissions**.
2. Under the role you want to grant access to, enable the **Can Audit** permission checkbox.

Once assigned, users with this role and permission can view and use the **Audit Messages Panel**.

In the next sub-sections, you can find more information about modifying your search results and checking the audit logs.