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

# Message Tracking

> Track user message activity, stats breakdown, and manage tracking blacklists.

# Message Tracking

<Badge variant="elite">Tier 1: Elite</Badge>

> Monitor server chat activity with precise message count metrics and exclude specific channels or categories from tracking.

***

## Commands Overview

| Command      | Aliases        | Syntax                                       | Description                                                 | Permissions   |
| :----------- | :------------- | :------------------------------------------- | :---------------------------------------------------------- | :------------ |
| `.messages`  | `m`, `message` | `.messages [@user \| userID]`                | Displays total and periodic message stats for a user.       | None          |
| `.blacklist` | `bl`           | `.blacklist <subcommand> <channel/category>` | Blacklist channels/categories from message and voice stats. | Administrator |

***

## Message Statistics

### messages

View detailed message statistics for yourself or another member in the server, including daily, weekly, and total counts.

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    .messages [@user | userID]
    ```
  </Tab>

  <Tab title="Examples">
    ```bash theme={null} theme={null}
    .messages
    .messages @User
    .messages 1191399940014997584
    ```
  </Tab>
</Tabs>

* **Aliases**: `m`, `message`
* **User Permissions**: None

***

## Tracking Blacklist

### blacklist

Exclude bot-spam channels, staff channels, or entire categories from counting towards message and voice statistics.

| Subcommand | Syntax                                    | Description                                                | Example                           |
| :--------- | :---------------------------------------- | :--------------------------------------------------------- | :-------------------------------- |
| `add`      | `.blacklist add <#channel\|channelId>`    | Adds a channel or category to tracking blacklist           | `.blacklist add #spam-channel`    |
| `remove`   | `.blacklist remove <#channel\|channelId>` | Removes a channel/category from blacklist                  | `.blacklist remove #spam-channel` |
| `list`     | `.blacklist list`                         | Displays all currently blacklisted channels and categories | `.blacklist list`                 |

* **Aliases**: `bl` (subcommand alias: `view` for `list`)
* **User Permissions**: Administrator

<Tabs>
  <Tab title="Blacklist Channel">
    ```bash theme={null} theme={null}
    .blacklist add #bot-commands
    ```
  </Tab>

  <Tab title="Remove Blacklist">
    ```bash theme={null} theme={null}
    .blacklist remove #bot-commands
    ```
  </Tab>

  <Tab title="View List">
    ```bash theme={null} theme={null}
    .blacklist list
    ```
  </Tab>
</Tabs>