> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-rn-guide-message-privately.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SMS Preferences

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

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

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/9bgr-iIAUJixmNKk/images/sms-notification-preferences.png?fit=max&auto=format&n=9bgr-iIAUJixmNKk&q=85&s=972939968c88661029330fd3e8f4895c" 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.