> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-restapi-chat-api-eng-37141.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Preferences

> Configure CometChat email notification preferences for unread messages, wait times, daily limits, overrides, and payload fields.

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

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-restapi-chat-api-eng-37141/24MBuHCELPa6fFpP/images/email-notification-preferences.png?fit=max&auto=format&n=24MBuHCELPa6fFpP&q=85&s=bac6e759d21b88fdd9b91527be36fe57" 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**