> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-react-ui-kit-plugin-precedence.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-react-ui-kit-plugin-precedence/7qKGdxJ-ugUIzvHo/images/sms-notification-preferences.png?fit=max&auto=format&n=7qKGdxJ-ugUIzvHo&q=85&s=b5d8f7fb730a8beba5a1256d886f89e6" 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.