> ## 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.

# SMS Preferences

> SMS Preferences — CometChat documentation.

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

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b/l9jOOlwBkJ6-pebk/images/sms-notification-preferences.png?fit=max&auto=format&n=l9jOOlwBkJ6-pebk&q=85&s=e5a66d4ac0f41540ff66edc5422ff2c7" width="2508" height="1128" data-path="images/sms-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 SMSes per day**: default 20.
* **Maximum SMSes per conversation per day**: default 2.
* **Override**: when enabled, end users can change these settings in clients that expose preferences.

## SMS 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**

Keep SMS payloads concise to avoid exceeding downstream provider limits.