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

# Core

> Overview of CometChat's core chat features including instant messaging, media sharing, read receipts, typing indicators, user presence, reactions, mentions, threaded conversations, and moderation.

<Accordion title="AI Integration Quick Reference">
  | Field          | Value                                                                                                                                                                                                                             |
  | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Packages       | `com.cometchat:chatuikit-kotlin-android` (Kotlin XML Views), `com.cometchat:chatuikit-compose-android` (Jetpack Compose)                                                                                                          |
  | Required setup | `CometChatUIKit.init()` then `CometChatUIKit.login()` — must complete before rendering any component                                                                                                                              |
  | Core features  | Instant Messaging, Media Sharing, Read Receipts, Mark as Unread, Typing Indicator, User Presence, Reactions, Mentions, Rich Text Formatting, Quoted Reply, Search, Threaded Conversations, Moderation, Report Message, Group Chat |
  | Key components | `CometChatConversations`, `CometChatMessageList`, `CometChatMessageComposer`, `CometChatMessageHeader`, `CometChatUsers`, `CometChatGroups`, `CometChatGroupMembers`, `CometChatMessageInformation`, `CometChatThreadHeader`      |
  | Theming        | See [Theming](/ui-kit/android/v6/theme-introduction)                                                                                                                                                                              |
</Accordion>

The UI Kit components work together to deliver a complete chat experience. The sections below map each core feature to the components that power it.

## Instant Messaging

Real-time text messaging — users can send and receive instant messages.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/_MYSdWhXnUkTkjEH/images/4c141125-Instant_Messaging-3e86359342605c94dc912604de8f6617.png?fit=max&auto=format&n=_MYSdWhXnUkTkjEH&q=85&s=ea314bc63185dde3da453141d788d612" width="1440" height="833" data-path="images/4c141125-Instant_Messaging-3e86359342605c94dc912604de8f6617.png" />
</Frame>

| Component                                                       | Role                                                   |
| --------------------------------------------------------------- | ------------------------------------------------------ |
| [CometChatMessageComposer](/ui-kit/android/v6/message-composer) | Enables users to write and send text messages.         |
| [CometChatMessageList](/ui-kit/android/v6/message-list)         | Renders sent and received messages using text bubbles. |

## Media Sharing

Share images, videos, audio files, and documents within conversations.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/mkn0UqPQ5BXljCV1/images/8fa177a9-Media_Sharing-e84fa670d754f58294c0c31611107ef7.png?fit=max&auto=format&n=mkn0UqPQ5BXljCV1&q=85&s=ed0e226186c7b3a70a3109032440e2a3" width="1440" height="833" data-path="images/8fa177a9-Media_Sharing-e84fa670d754f58294c0c31611107ef7.png" />
</Frame>

| Component                                                       | Role                                                                                                                                                                                                                                                                                              |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [CometChatMessageComposer](/ui-kit/android/v6/message-composer) | Provides an action sheet with options for sharing media files.                                                                                                                                                                                                                                    |
| [CometChatMessageList](/ui-kit/android/v6/message-list)         | Renders media message bubbles — [Image](/ui-kit/android/v6/message-bubble-styling#image-bubble), [File](/ui-kit/android/v6/message-bubble-styling#file-bubble), [Audio](/ui-kit/android/v6/message-bubble-styling#audio-bubble), [Video](/ui-kit/android/v6/message-bubble-styling#video-bubble). |

## Read Receipts

Visibility into message status — delivered and read indicators.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/mNTojjz_O28of40c/images/f829cdd9-Read_receipts-a80d8b2b78b4491ef118cf971d26172f.png?fit=max&auto=format&n=mNTojjz_O28of40c&q=85&s=29179174aaeaba5ac2082bb29151a397" width="1440" height="833" data-path="images/f829cdd9-Read_receipts-a80d8b2b78b4491ef118cf971d26172f.png" />
</Frame>

| Component                                                                               | Role                                                                    |
| --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| [CometChatConversations](/ui-kit/android/v6/conversations)                              | Displays delivery status of the last message in each conversation item. |
| [CometChatMessageList](/ui-kit/android/v6/message-list)                                 | Shows read receipt status on every message bubble.                      |
| [CometChatMessageInformation](/ui-kit/android/v6/component-styling#message-information) | Shows detailed delivery and read status for a specific sent message.    |

## Mark as Unread

Users can manually mark messages as unread to revisit important conversations later. The message list can start from the first unread message automatically.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/19qJLi95IaEk2j9s/images/mark-as-unread.png?fit=max&auto=format&n=19qJLi95IaEk2j9s&q=85&s=1d7dc33b9abdb18d88f6b8f1f480e048" width="2560" height="1670" data-path="images/mark-as-unread.png" />
</Frame>

| Component                                                  | Role                                                                                                         |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| [CometChatMessageList](/ui-kit/android/v6/message-list)    | Provides the "Mark as unread" option in message actions and supports starting from the first unread message. |
| [CometChatConversations](/ui-kit/android/v6/conversations) | Reflects updated unread count in real-time.                                                                  |

## Typing Indicators

Shows when a user is typing a response in real-time.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/_MYSdWhXnUkTkjEH/images/487fa6c8-Typing_Indicator-7031ffbfb2da1bca5f70799de5250157.png?fit=max&auto=format&n=_MYSdWhXnUkTkjEH&q=85&s=351b83e4d806eda06f3ca6bd6a3c2009" width="1440" height="833" data-path="images/487fa6c8-Typing_Indicator-7031ffbfb2da1bca5f70799de5250157.png" />
</Frame>

| Component                                                   | Role                                                                              |
| ----------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [CometChatConversations](/ui-kit/android/v6/conversations)  | Shows real-time typing status in conversation items.                              |
| [CometChatMessageHeader](/ui-kit/android/v6/message-header) | Displays a "typing..." indicator when the other user or a group member is typing. |

## User Presence

See whether contacts are online or offline.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/Gp90C5sdVtuRR4t7/images/7fa65ca5-User_Presence-10eed341028f3a7812c410accc46fa66.png?fit=max&auto=format&n=Gp90C5sdVtuRR4t7&q=85&s=5843f22bb6afd13e82595248681f56c9" width="1440" height="833" data-path="images/7fa65ca5-User_Presence-10eed341028f3a7812c410accc46fa66.png" />
</Frame>

| Component                                                   | Role                                         |
| ----------------------------------------------------------- | -------------------------------------------- |
| [CometChatConversations](/ui-kit/android/v6/conversations)  | Shows user presence in conversation items.   |
| [CometChatMessageHeader](/ui-kit/android/v6/message-header) | Displays user presence in the chat header.   |
| [CometChatUsers](/ui-kit/android/v6/users)                  | Shows presence indicators in the user list.  |
| [CometChatGroupMembers](/ui-kit/android/v6/group-members)   | Shows presence indicators for group members. |

## Reactions

React to messages with emojis without typing a full response.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/xIG5VBdyNJ5cYSqE/images/d2e11729-Reactions-683bff07964d09dee60dec2d7e4f25d9.png?fit=max&auto=format&n=xIG5VBdyNJ5cYSqE&q=85&s=3006daa2cc6e8fc875653fd6ca92ca84" width="1440" height="833" data-path="images/d2e11729-Reactions-683bff07964d09dee60dec2d7e4f25d9.png" />
</Frame>

| Component                                               | Role                                                                    |
| ------------------------------------------------------- | ----------------------------------------------------------------------- |
| [CometChatMessageList](/ui-kit/android/v6/message-list) | Displays reactions on message bubbles and provides the reaction picker. |

## Mentions

Address specific users in a conversation by typing `@` to trigger mention suggestions.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/PaxBG9I1yMoeQmt2/images/3baa8c0d-Mentions-d49539d8def32f2c894fc16c51fcf89e.png?fit=max&auto=format&n=PaxBG9I1yMoeQmt2&q=85&s=8abb79beb360e163670c4d648e9f4cb9" width="1440" height="564" data-path="images/3baa8c0d-Mentions-d49539d8def32f2c894fc16c51fcf89e.png" />
</Frame>

| Component                                                       | Role                                                                |
| --------------------------------------------------------------- | ------------------------------------------------------------------- |
| [CometChatConversations](/ui-kit/android/v6/conversations)      | Shows where users have been mentioned from the conversation list.   |
| [CometChatMessageComposer](/ui-kit/android/v6/message-composer) | Triggers mention suggestions on `@` and inserts formatted mentions. |
| [CometChatMessageList](/ui-kit/android/v6/message-list)         | Renders mentions with distinct styling in the message flow.         |

## Rich Text Formatting

Rich Text Formatting allows users to style their messages with bold, italic, strikethrough, code, code blocks, blockquotes, ordered/unordered lists, and links. This brings richer expression to conversations and helps users emphasize key points.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/21UBnagXOw-XG0Sv/images/android-rich-text-formatting.png?fit=max&auto=format&n=21UBnagXOw-XG0Sv&q=85&s=2d3ea87eedd0bbab58d28be16c9fc758" width="1680" height="972" data-path="images/android-rich-text-formatting.png" />
</Frame>

| Component                                                       | Role                                                                                                                                                                          |
| --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [CometChatMessageComposer](/ui-kit/android/v6/message-composer) | Provides a built-in rich text editor with formatting toolbar and text selection menu items for bold, italic, strikethrough, code, links, lists, blockquotes, and code blocks. |
| [CometChatMessageList](/ui-kit/android/v6/message-list)         | Renders formatted messages with the appropriate styling automatically applied, ensuring that rich text formatting is displayed exactly as intended by the sender.             |

## Threaded Conversations

Respond directly to a specific message, keeping conversations organized.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/jpEUuHUk-hvu4tQT/images/a6e3a880-Threads-5f934d4ff0595625af777471e5e162dc.png?fit=max&auto=format&n=jpEUuHUk-hvu4tQT&q=85&s=04c944a4ffb42ce2c4917c7bda8b3195" width="1440" height="1128" data-path="images/a6e3a880-Threads-5f934d4ff0595625af777471e5e162dc.png" />
</Frame>

| Component                                                            | Role                                               |
| -------------------------------------------------------------------- | -------------------------------------------------- |
| [CometChatThreadHeader](/ui-kit/android/v6/threaded-messages-header) | Displays all replies made to a particular message. |
| [CometChatMessageComposer](/ui-kit/android/v6/message-composer)      | Allows composing messages within a thread.         |
| [CometChatMessageList](/ui-kit/android/v6/message-list)              | Displays threaded messages in context.             |

## Quoted Replies

Reply to specific messages by selecting "Reply" from the message action menu, maintaining context in the conversation.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/21UBnagXOw-XG0Sv/images/android-quoted-reply.png?fit=max&auto=format&n=21UBnagXOw-XG0Sv&q=85&s=79b4e1155dd286267b651b1e2add6ab9" width="2560" height="1670" data-path="images/android-quoted-reply.png" />
</Frame>

| Component                                                       | Role                                                      |
| --------------------------------------------------------------- | --------------------------------------------------------- |
| [CometChatMessageList](/ui-kit/android/v6/message-list)         | Provides the "Reply" option in message actions.           |
| [CometChatMessageComposer](/ui-kit/android/v6/message-composer) | Shows the quoted reply above the input field for context. |

## Group Chats

Conversations with multiple participants — team collaborations, group discussions, and communities.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/le8ibYc8lBJsShSE/images/583bd229-Group_Conversation-19f24a8fa85e09324c28f4fd335e2951.png?fit=max&auto=format&n=le8ibYc8lBJsShSE&q=85&s=07cc9d1d4296c45b64a1670169cbaec8" width="1440" height="833" data-path="images/583bd229-Group_Conversation-19f24a8fa85e09324c28f4fd335e2951.png" />
</Frame>

| Component                                                 | Role                                                       |
| --------------------------------------------------------- | ---------------------------------------------------------- |
| [CometChatGroups](/ui-kit/android/v6/groups)              | Lists and manages groups.                                  |
| [CometChatGroupMembers](/ui-kit/android/v6/group-members) | Displays and manages group members with roles and actions. |

## Moderation

Automatically filter and manage inappropriate content based on predefined rules.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/19qJLi95IaEk2j9s/images/mobile-uikit-moderation-overview.png?fit=max&auto=format&n=19qJLi95IaEk2j9s&q=85&s=328e6452df98ea3737ae567d2d6a930c" width="1680" height="972" data-path="images/mobile-uikit-moderation-overview.png" />
</Frame>

<Note>
  Learn more about setting up moderation rules in the [Moderation](/moderation/overview) documentation.
</Note>

| Component                                               | Role                                                                                      |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| [CometChatMessageList](/ui-kit/android/v6/message-list) | Handles moderated messages, displaying blocked content based on your moderation settings. |

## Report Message

Users can report inappropriate messages by choosing from predefined reasons with optional remarks.

<Note>
  Learn more about flagged messages in the [Flagged Messages](/moderation/flagged-messages) documentation.
</Note>

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/21UBnagXOw-XG0Sv/images/android-flag-message.png?fit=max&auto=format&n=21UBnagXOw-XG0Sv&q=85&s=520f791df7941a437d5eaed6d3fb682a" width="2518" height="1704" data-path="images/android-flag-message.png" />
</Frame>

| Component                                               | Role                                                     |
| ------------------------------------------------------- | -------------------------------------------------------- |
| [CometChatMessageList](/ui-kit/android/v6/message-list) | Provides the "Report Message" option in message actions. |

## Conversation and Advanced Search

Conversation and Advanced Search enables users to quickly find conversations, messages, and media across chats in real time. It supports filters, scopes, and custom actions, allowing users to locate content efficiently while keeping the chat experience smooth and intuitive.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-docs-rn-guide-message-privately/21UBnagXOw-XG0Sv/images/android-search-overview.png?fit=max&auto=format&n=21UBnagXOw-XG0Sv&q=85&s=7e01a39ddbc2d012e6e9be1a8daeb421" width="2560" height="1670" data-path="images/android-search-overview.png" />
</Frame>

| Component                                                   | Role                                                                                                                                                                |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [CometChatSearch](/ui-kit/android/v6/search)                | Allows users to search across conversations and messages in real time. Users can click on a result to open the conversation or jump directly to a specific message. |
| [CometChatMessageHeader](/ui-kit/android/v6/message-header) | Shows the search button in the chat header, allowing users to search within a conversation.                                                                         |
| [CometChatMessageList](/ui-kit/android/v6/message-list)     | Shows the selected message when clicked from search results and highlights it in the message list.                                                                  |
| [CometChatConversations](/ui-kit/android/v6/conversations)  | Displays the search input.                                                                                                                                          |

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Components Overview" icon="grid-2" href="/ui-kit/android/v6/components-overview">
    Browse all available UI Kit components
  </Card>

  <Card title="Theme" icon="palette" href="/ui-kit/android/v6/theme-introduction">
    Customize the look and feel of your chat UI
  </Card>

  <Card title="Call Features" icon="phone" href="/ui-kit/android/v6/call-features">
    Add audio and video calling
  </Card>

  <Card title="AI Features" icon="robot" href="/ui-kit/android/v6/ai-features">
    Explore AI-powered chat capabilities
  </Card>
</CardGroup>
