> ## Documentation Index
> Fetch the complete documentation index at: https://www.cometchat.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Flagged Messages

> Flagged Messages — CometChat documentation.

Flagged Messages allows moderators to review messages that have been flagged for potentially violating moderation rules. Messages can be flagged automatically by the rule engine or manually by end users who find content inappropriate.

<Note>
  Flagged messages remain visible to users until a moderator reviews and takes action.
</Note>

***

## Quick Start

Review flagged messages in under 2 minutes:

<Steps>
  <Step title="Open Flagged Messages">
    Login to [CometChat Dashboard](https://app.cometchat.com) → Select your app → **Moderation** → **Flagged Messages**
  </Step>

  <Step title="Review a Message">
    Click on a flagged message to see details, context, and the reason it was flagged
  </Step>

  <Step title="Take Action">
    Click **Approve** (message stays visible) or **Block** (message is hidden)
  </Step>
</Steps>

***

## How It Works

```mermaid theme={null}
flowchart LR
    A[Message Sent] --> B{Flagging}
    B --> C[Manual Flag by User]
    B --> D[Auto Flag by Rule Engine]
    C --> E[Review Queue]
    D --> E
    E --> F{Moderator Action}
    F --> G[Approve]
    F --> H[Block]
    G --> I[Reviewed List]
    H --> I
```

| Step                | Description                                                                     |
| ------------------- | ------------------------------------------------------------------------------- |
| 1. Message Sent     | A user sends a message in a conversation                                        |
| 2. Flagging         | Message is flagged either manually by users or automatically by the rule engine |
| 3. Review Queue     | Flagged message appears in the Dashboard for moderator review                   |
| 4. Moderator Action | Moderator reviews and either approves or blocks the message                     |
| 5. Reviewed List    | Message moves to the reviewed list with its final status                        |

***

## Flagging Methods

<Tabs>
  <Tab title="Manual Flagging">
    End users can manually flag messages they find inappropriate by selecting from a predefined list of reasons.

    <Frame>
      <img src="https://mintcdn.com/cometchat-22654f5b/60PLc7EjE9L6tcha/images/report_message.png?fit=max&auto=format&n=60PLc7EjE9L6tcha&q=85&s=377c15142ad1b674dd1550cd01a342d8" width="2518" height="1704" data-path="images/report_message.png" />
    </Frame>

    **Configure flag reasons:** Dashboard → **Moderation** → **Advanced Settings**

    <Frame>
      <img src="https://mintcdn.com/cometchat-22654f5b/ufFyCNLdnAL0x7An/images/flag_reasons_default.png?fit=max&auto=format&n=ufFyCNLdnAL0x7An&q=85&s=4b0987500e6b035ce6d0df1d6976c329" width="2560" height="784" data-path="images/flag_reasons_default.png" />
    </Frame>
  </Tab>

  <Tab title="Automatic Flagging">
    Messages are automatically flagged when they match moderation rules configured with the "Flag" action.

    <Frame>
      <img src="https://mintcdn.com/cometchat-22654f5b/60PLc7EjE9L6tcha/images/rule_engine_flag.png?fit=max&auto=format&n=60PLc7EjE9L6tcha&q=85&s=f2693b5feb330c38da1de6c2034d53f4" width="1398" height="1386" data-path="images/rule_engine_flag.png" />
    </Frame>

    **Set up auto-flagging:** Create a rule in [Rules Management](/moderation/rules-management) with Action set to "Flag"
  </Tab>
</Tabs>

***

## Enable Flagging in Your App

<AccordionGroup>
  <Accordion title="UI Kits">
    The Report Message feature is available in CometChat UI Kits. Users can report messages directly from the message actions menu:

    <CardGroup cols={3}>
      <Card title="React" icon={<img src="/images/icons/react.svg" alt="React" />} href="/ui-kit/react/core-features#report-message" horizontal />

      <Card title="React Native" icon={<img src="/images/icons/react.svg" alt="React Native" />} href="/ui-kit/react-native/core-features" horizontal />

      <Card title="Android" icon={<img src="/images/icons/android.svg" alt="Android" />} href="/ui-kit/android/core-features" horizontal />

      <Card title="iOS" icon={<img src="/images/icons/swift.svg" alt="iOS" />} href="/ui-kit/ios/core-features" horizontal />

      <Card title="Flutter" icon={<img src="/images/icons/flutter.svg" alt="Flutter" />} href="/ui-kit/flutter/core-features" horizontal />

      <Card title="Angular" icon={<img src="/images/icons/angular.svg" alt="Angular" />} href="/ui-kit/angular/core-features" horizontal />

      <Card title="Vue" icon={<img src="/images/icons/vuejs.svg" alt="Vue" />} href="/ui-kit/vue/overview" horizontal />
    </CardGroup>
  </Accordion>

  <Accordion title="Chat SDKs">
    Implement message flagging directly using CometChat Chat SDKs:

    <CardGroup cols={3}>
      <Card title="JavaScript" icon={<img src="/images/icons/js.svg" alt="JavaScript" />} href="/sdk/javascript/flag-message" horizontal />

      <Card title="React Native" icon={<img src="/images/icons/react.svg" alt="React Native" />} href="/sdk/react-native/flag-message" horizontal />

      <Card title="Android" icon={<img src="/images/icons/android.svg" alt="Android" />} href="/sdk/android/flag-message" horizontal />

      <Card title="iOS" icon={<img src="/images/icons/swift.svg" alt="iOS" />} href="/sdk/ios/flag-message" horizontal />

      <Card title="Flutter" icon={<img src="/images/icons/flutter.svg" alt="Flutter" />} href="/sdk/flutter/flag-message" horizontal />
    </CardGroup>
  </Accordion>
</AccordionGroup>

***

## Managing Flagged Messages

### List Flagged Messages

View all messages pending review in the Flagged Messages tab.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b/DNsV3YDy9ekaHd4T/images/1600d6b8-moderation_list_flagged_messages-1a2b3c4d5e6f7g8h9i0j.png?fit=max&auto=format&n=DNsV3YDy9ekaHd4T&q=85&s=95290732478e1b128b07bd517e7f8a9f" width="2555" height="1289" data-path="images/1600d6b8-moderation_list_flagged_messages-1a2b3c4d5e6f7g8h9i0j.png" />
</Frame>

### Approve Message

Approving indicates the message is acceptable. It remains visible to all users and moves to the Reviewed list.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b/DNsV3YDy9ekaHd4T/images/1600d6b8-moderation_approve_flagged_message-2b3c4d5e6f7g8h9i0j1a.png?fit=max&auto=format&n=DNsV3YDy9ekaHd4T&q=85&s=759e01059afaf8636efca4f66c36bf5d" width="2555" height="1289" data-path="images/1600d6b8-moderation_approve_flagged_message-2b3c4d5e6f7g8h9i0j1a.png" />
</Frame>

### Block Message

Blocking marks the message as disapproved. It's hidden from the conversation and moves to the Reviewed list.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b/DNsV3YDy9ekaHd4T/images/1600d6b8-moderation_block_flagged_message-3c4d5e6f7g8h9i0j1a2b.png?fit=max&auto=format&n=DNsV3YDy9ekaHd4T&q=85&s=bcd277fc527bdad816fa050cbec88cae" width="2555" height="1289" data-path="images/1600d6b8-moderation_block_flagged_message-3c4d5e6f7g8h9i0j1a2b.png" />
</Frame>

<Tip>
  **Bulk actions supported.** Select multiple flagged messages and approve or block them in a single action.
</Tip>

***

## FAQ

<AccordionGroup>
  <Accordion title="What happens to blocked messages?">
    Blocked messages are hidden from the conversation and no longer visible to users. The message is marked as disapproved and moved to the Reviewed list.
  </Accordion>

  <Accordion title="Can users see if their message was blocked?">
    By default, users are not notified when their message is blocked. The message simply becomes hidden from the conversation.
  </Accordion>

  <Accordion title="Can I bulk approve or block messages?">
    Yes, the Dashboard supports bulk actions. Select multiple flagged messages and approve or block them in a single action.
  </Accordion>

  <Accordion title="What's the difference between flagged and blocked messages?">
    Flagged messages are pending review and remain visible until a moderator takes action. Blocked messages are immediately hidden and don't require review.
  </Accordion>
</AccordionGroup>

***

## Related Resources

<CardGroup cols={2}>
  <Card title="Rules Management" icon="shield-check" href="/moderation/rules-management">
    Configure rules to auto-flag messages
  </Card>

  <Card title="Blocked Messages" icon="ban" href="/moderation/blocked-messages">
    View immediately blocked content
  </Card>

  <Card title="Lists Management" icon="list" href="/moderation/lists-management">
    Create keyword lists for flagging
  </Card>

  <Card title="Moderation Overview" icon="eye" href="/moderation/overview">
    Learn about the moderation system
  </Card>
</CardGroup>