> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-feature-android-multimedia-attachments.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-feature-android-multimedia-attachments/0IK7MlJ9Y4AvJ753/images/4c141125-Instant_Messaging-3e86359342605c94dc912604de8f6617.png?fit=max&auto=format&n=0IK7MlJ9Y4AvJ753&q=85&s=c49f2fbd9a0ccc0aadd2c96cd7fdf346" 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 multiple images, videos, audio files, and documents in a single send. Tapping the attachment button opens a multi-select picker; the picks stage in a preview tray above the input box with per-file upload progress, and send together with an optional caption — all out of the box.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-feature-android-multimedia-attachments/0xqWv6OXtYPSqnvx/images/8fa177a9-Media_Sharing-e84fa670d754f58294c0c31611107ef7.png?fit=max&auto=format&n=0xqWv6OXtYPSqnvx&q=85&s=954764fd85fb537aa8aded6da67d4eec" width="1440" height="833" data-path="images/8fa177a9-Media_Sharing-e84fa670d754f58294c0c31611107ef7.png" />
</Frame>

| Component                                                                            | Role                                                                                                          |
| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| [CometChatMessageComposer](/ui-kit/android/v6/message-composer#multiple-attachments) | Multi-select picker, an attachment tray that uploads before send, and the composer text as the batch caption. |
| [CometChatMessageList](/ui-kit/android/v6/message-list#multiple-attachments)         | Renders received attachments with per-type bubbles and groups a multi-type send as one visual batch.          |

A mixed pick is split into one message per attachment type (images → videos → audios → files) that render as grouped bubbles: an image/video **grid**, a stacked **audio player** list, and a connected **file card** stack. Per-message file count and per-file size limits come from your app's dashboard settings.

**Supported media types:**

| Type   | Single                                                                               | Multiple                                                                           |
| ------ | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| Images | [Image Bubble](/ui-kit/android/v6/message-bubble-styling#image-bubble)               | [Media Grid Bubble](/ui-kit/android/v6/message-bubble-styling#media-grid-bubble)   |
| Videos | [Video Bubble](/ui-kit/android/v6/message-bubble-styling#video-bubble)               | [Media Grid Bubble](/ui-kit/android/v6/message-bubble-styling#media-grid-bubble)   |
| Audio  | [Audio Bubble](/ui-kit/android/v6/message-bubble-styling#audio-bubble) (voice notes) | [Audio Files Bubble](/ui-kit/android/v6/message-bubble-styling#audio-files-bubble) |
| Files  | [File Bubble](/ui-kit/android/v6/message-bubble-styling#file-bubble)                 | [Files Bubble](/ui-kit/android/v6/message-bubble-styling#files-bubble)             |

## Read Receipts

Visibility into message status — delivered and read indicators.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b-feature-android-multimedia-attachments/fIgcst14S8u4zHie/images/f829cdd9-Read_receipts-a80d8b2b78b4491ef118cf971d26172f.png?fit=max&auto=format&n=fIgcst14S8u4zHie&q=85&s=2de56cc554a33a9659e0fc14bbe43c4a" 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-feature-android-multimedia-attachments/_us1Kqcow7XVLxei/images/mark-as-unread.png?fit=max&auto=format&n=_us1Kqcow7XVLxei&q=85&s=b71c962805424f4fa87098b055f0ee4f" 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-feature-android-multimedia-attachments/0IK7MlJ9Y4AvJ753/images/487fa6c8-Typing_Indicator-7031ffbfb2da1bca5f70799de5250157.png?fit=max&auto=format&n=0IK7MlJ9Y4AvJ753&q=85&s=c80185faa31b62d333a7daca7ecad44f" 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-feature-android-multimedia-attachments/9JyRgaC40KwTXeM8/images/7fa65ca5-User_Presence-10eed341028f3a7812c410accc46fa66.png?fit=max&auto=format&n=9JyRgaC40KwTXeM8&q=85&s=9f2d34bfbd209c4c14b0588fa9ff53dd" 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-feature-android-multimedia-attachments/4-RLyvAJsa4c7_Nm/images/d2e11729-Reactions-683bff07964d09dee60dec2d7e4f25d9.png?fit=max&auto=format&n=4-RLyvAJsa4c7_Nm&q=85&s=cdd8b841eaf0c91a217aaff334078e28" 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-feature-android-multimedia-attachments/YgamkpALQ8hAKN_V/images/3baa8c0d-Mentions-d49539d8def32f2c894fc16c51fcf89e.png?fit=max&auto=format&n=YgamkpALQ8hAKN_V&q=85&s=de3b307165f1c997c4b9f9e2e0a7ba0c" 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-feature-android-multimedia-attachments/JWIhqTrVQkhVmnq6/images/android-rich-text-formatting.png?fit=max&auto=format&n=JWIhqTrVQkhVmnq6&q=85&s=0e5442474eb4aa21a2fd73a36014d50b" 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-feature-android-multimedia-attachments/p4P_akATmcxkpYvT/images/a6e3a880-Threads-5f934d4ff0595625af777471e5e162dc.png?fit=max&auto=format&n=p4P_akATmcxkpYvT&q=85&s=ca92cafde070d41c7af86c12c46f338b" 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-feature-android-multimedia-attachments/JWIhqTrVQkhVmnq6/images/android-quoted-reply.png?fit=max&auto=format&n=JWIhqTrVQkhVmnq6&q=85&s=7bacd1e16f4d5e21ec38b9c8b39cd759" 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-feature-android-multimedia-attachments/9cd7-IpApPR9T1nD/images/583bd229-Group_Conversation-19f24a8fa85e09324c28f4fd335e2951.png?fit=max&auto=format&n=9cd7-IpApPR9T1nD&q=85&s=3fa6f759487e71676abb2e4c48bb6941" 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-feature-android-multimedia-attachments/FUEOG3yT3IUr-kQk/images/mobile-uikit-moderation-overview.png?fit=max&auto=format&n=FUEOG3yT3IUr-kQk&q=85&s=dfbc1ab91c8a973fa8140a1da1aa5332" 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-feature-android-multimedia-attachments/JWIhqTrVQkhVmnq6/images/android-flag-message.png?fit=max&auto=format&n=JWIhqTrVQkhVmnq6&q=85&s=0724f3141deff7f7a6befad3f0e802ed" 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-feature-android-multimedia-attachments/JWIhqTrVQkhVmnq6/images/android-search-overview.png?fit=max&auto=format&n=JWIhqTrVQkhVmnq6&q=85&s=5460bb369a5de67208fa73d036f00b0b" 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>