> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-ios-ui-kit-sdk-fixes.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CometChat Settings Guide

> Comprehensive reference for all CometChatSettings options.

The `CometChatSettings` object controls everything the React Builder renders—messaging, AI helpers, calls, layout, theming, and agent tools. Use this page as a definitive map of every toggle with recommended defaults.

## Top-level structure

```ts theme={null}
export interface CometChatSettings {
  chatFeatures: { ... }
  callFeatures: { ... }
  layout: { ... }
  style: { ... }  
}
```

***

## 1. Chat Features (`chatFeatures`)

### 1.1 Core Messaging Experience (`coreMessagingExperience`)

Controls the essentials of chat.

| Property                       | Type               | Description                                |
| ------------------------------ | ------------------ | ------------------------------------------ |
| typingIndicator                | boolean            | Show “user is typing” state.               |
| threadConversationAndReplies   | boolean            | Enable threaded conversations and replies. |
| photosSharing                  | boolean            | Allow sharing images.                      |
| videoSharing                   | boolean            | Allow sharing videos.                      |
| audioSharing                   | boolean            | Allow sharing audio clips.                 |
| fileSharing                    | boolean            | Allow generic file uploads.                |
| editMessage                    | boolean            | Let users edit their sent messages.        |
| deleteMessage                  | boolean            | Let users delete their sent messages.      |
| messageDeliveryAndReadReceipts | boolean            | Show delivery/read receipts.               |
| userAndFriendsPresence         | boolean            | Display online/offline presence.           |
| conversationAndAdvancedSearch  | boolean (optional) | Enable conversation + advanced search.     |
| moderation                     | boolean (optional) | Turn on content moderation tools.          |
| quotedReplies                  | boolean (optional) | Allow quoting messages.                    |
| markAsUnread                   | boolean (optional) | Let users mark messages as unread.         |

### 1.2 Deeper User Engagement (`deeperUserEngagement`)

Richer ways to participate.

| Property                | Type               | Description                                 |
| ----------------------- | ------------------ | ------------------------------------------- |
| mentions                | boolean            | Enable @mentions.                           |
| mentionAll              | boolean (optional) | Allow @all to notify everyone in the group. |
| reactions               | boolean            | Emoji/label reactions on messages.          |
| messageTranslation      | boolean            | Inline message translation.                 |
| polls                   | boolean            | Create and vote on polls.                   |
| collaborativeWhiteboard | boolean            | Real-time whiteboard.                       |
| collaborativeDocument   | boolean            | Collaborative docs.                         |
| voiceNotes              | boolean            | Voice-note capture and send.                |
| emojis                  | boolean            | Emoji keyboard support.                     |
| stickers                | boolean            | Sticker sending.                            |
| userInfo                | boolean            | View user profile info.                     |
| groupInfo               | boolean            | View group details.                         |
| reportMessage           | boolean (optional) | Allow reporting a message.                  |

### 1.3 AI User Copilot (`aiUserCopilot`)

AI assistance inside chat.

| Property            | Type    | Description                                |
| ------------------- | ------- | ------------------------------------------ |
| conversationStarter | boolean | Suggest AI-generated conversation openers. |
| conversationSummary | boolean | Summaries of chat threads.                 |
| smartReply          | boolean | Quick replies suggested by AI.             |

### 1.4 User Management (`userManagement`) — Optional

| Property    | Type               | Description                         |
| ----------- | ------------------ | ----------------------------------- |
| friendsOnly | boolean (optional) | Restrict chat to friends-only mode. |

### 1.5 Group Management (`groupManagement`)

| Property           | Type    | Description                    |
| ------------------ | ------- | ------------------------------ |
| createGroup        | boolean | Allow users to create groups.  |
| addMembersToGroups | boolean | Add members to groups.         |
| joinLeaveGroup     | boolean | Join or leave groups.          |
| deleteGroup        | boolean | Allow admins to delete groups. |
| viewGroupMembers   | boolean | Show group member list.        |

### 1.6 Moderator Controls (`moderatorControls`)

| Property             | Type               | Description               |
| -------------------- | ------------------ | ------------------------- |
| kickUsers            | boolean            | Kick users from groups.   |
| banUsers             | boolean            | Ban users from groups.    |
| promoteDemoteMembers | boolean            | Change a member’s scope.  |
| reportMessage        | boolean (optional) | Enable message reporting. |

### 1.7 Private Messaging Within Groups (`privateMessagingWithinGroups`)

| Property                         | Type    | Description                              |
| -------------------------------- | ------- | ---------------------------------------- |
| sendPrivateMessageToGroupMembers | boolean | DM group members from the group context. |

***

## 2. Call Features (`callFeatures`)

### 2.1 Voice and Video Calling (`voiceAndVideoCalling`)

| Property             | Type    | Description             |
| -------------------- | ------- | ----------------------- |
| oneOnOneVoiceCalling | boolean | One-to-one voice calls. |
| oneOnOneVideoCalling | boolean | One-to-one video calls. |
| groupVideoConference | boolean | Group video calls.      |
| groupVoiceConference | boolean | Group voice-only calls. |

***

## 3. Layout (`layout`)

| Property    | Type      | Description                                                |
| ----------- | --------- | ---------------------------------------------------------- |
| withSideBar | boolean   | Show/hide the sidebar.                                     |
| tabs        | string\[] | Tabs to expose, e.g. `['chats','calls','users','groups']`. |
| chatType    | string    | Default chat type: `'user'` or `'group'`.                  |

***

## 4. Style (`style`)

### 4.1 Theme

| Property | Type   | Description                         |
| -------- | ------ | ----------------------------------- |
| theme    | string | `'light'`, `'dark'`, or `'system'`. |

### 4.2 Color

| Property           | Type   | Description                         |
| ------------------ | ------ | ----------------------------------- |
| brandColor         | string | Primary UI color (hex).             |
| primaryTextLight   | string | Text color in light mode.           |
| primaryTextDark    | string | Text color in dark mode.            |
| secondaryTextLight | string | Secondary text color in light mode. |
| secondaryTextDark  | string | Secondary text color in dark mode.  |

### 4.3 Typography

| Property | Type   | Description                           |
| -------- | ------ | ------------------------------------- |
| font     | string | Font family (e.g., `'roboto'`).       |
| size     | string | Font size preset (e.g., `'default'`). |

***

## Example configuration

```json theme={null}
{
  "chatFeatures": {
    "coreMessagingExperience": {
      "typingIndicator": true,
      "threadConversationAndReplies": true,
      "photosSharing": true,
      "videoSharing": true,
      "audioSharing": true,
      "fileSharing": true,
      "editMessage": true,
      "deleteMessage": true,
      "messageDeliveryAndReadReceipts": true,
      "userAndFriendsPresence": true,
      "quotedReplies": true,
      "markAsUnread": true
    },
    "deeperUserEngagement": {
      "mentions": true,
      "mentionAll": false,
      "reactions": true,
      "messageTranslation": true,
      "polls": true,
      "collaborativeWhiteboard": false,
      "collaborativeDocument": false,
      "voiceNotes": true,
      "emojis": true,
      "stickers": true,
      "userInfo": true,
      "groupInfo": true
    },
    "aiUserCopilot": {
      "conversationStarter": true,
      "conversationSummary": true,
      "smartReply": true
    },
    "userManagement": { "friendsOnly": false },
    "groupManagement": {
      "createGroup": true,
      "addMembersToGroups": true,
      "joinLeaveGroup": true,
      "deleteGroup": true,
      "viewGroupMembers": true
    },
    "moderatorControls": {
      "kickUsers": true,
      "banUsers": true,
      "promoteDemoteMembers": true
    },
    "privateMessagingWithinGroups": {
      "sendPrivateMessageToGroupMembers": true
    }
  },
  "callFeatures": {
    "voiceAndVideoCalling": {
      "oneOnOneVoiceCalling": true,
      "oneOnOneVideoCalling": true,
      "groupVideoConference": true,
      "groupVoiceConference": true
    }
  },
  "layout": {
    "withSideBar": true,
    "tabs": ["chats", "calls", "users", "groups"],
    "chatType": "user"
  },
  "style": {
    "theme": "system",
    "color": {
      "brandColor": "#6852D6",
      "primaryTextLight": "#2B2B2B",
      "primaryTextDark": "#FFFFFF",
      "secondaryTextLight": "#727272",
      "secondaryTextDark": "#989898"
    },
    "typography": {
      "font": "roboto",
      "size": "default"
    }
  },
  "noCode": {
    "docked": true,
    "styles": {
      "buttonBackGround": "#6852D6",
      "buttonShape": "rounded",
      "openIcon": "https://example.com/open.svg",
      "closeIcon": "https://example.com/close.svg",
      "customJs": "console.log('hello from no-code')",
      "customCss": ".cc-chat { border-radius: 16px; }",
      "dockedAlignment": "right"
    }
  },
  "agent": {
    "chatHistory": true,
    "newChat": true,
    "agentIcon": "https://example.com/agent.png",
    "showAgentIcon": true
  }
}
```

***

## Tips

* Enable `conversationAndAdvancedSearch` when you need global search across conversations; keep it off for lighter builds.
* For enterprise moderation, pair `moderation` + `reportMessage` with your backend review queues.
* Keep `noCode.styles.customJs` minimal and sanitized; avoid long-running scripts to maintain widget performance.