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

# Email Preferences

> Email Preferences — CometChat documentation.

Control when CometChat sends unread-message emails and what data is included in each payload.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b/3b-2S_R7qI_2QSnJ/images/email-notification-preferences.png?fit=max&auto=format&n=3b-2S_R7qI_2QSnJ&q=85&s=1b4dce9a2f84ab3884a28e86b067d2c2" width="2502" height="1122" data-path="images/email-notification-preferences.png" />
</Frame>

## Delivery preferences

* **Notify for unread messages only** (default: on). When enabled, send only if the conversation has unread messages.
* **Wait time before sending the next notification (per conversation, minutes)**: default 120; min 1; max 1440.
* **Maximum emails per day**: default 20.
* **Maximum emails per conversation per day**: default 2.
* **Override**: when enabled, end users can change these settings in clients that expose preferences.

## Email payload options

All toggles default to off; enable per your privacy/performance needs.

* **Include entire message object in payload**
* **Include message metadata in payload**
* **Include sender's metadata in payload**
* **Include receiver's metadata in payload**