Moderation

Flag messages for review and track moderation status.

The CometChat Unreal SDK provides moderation tools to let users report inappropriate content. You can flag messages with a reason, fetch available flag reasons, and track moderation status on messages.

---

Flag a Message

Use the Flag Message Async node to report a message for moderation review.

Blueprint

1. Create an FCometChatFlagDetail struct with the ReasonId and optional Remark
2. Call the Flag Message Async node with the message ID and flag detail
3. Handle On Success (message flagged) or On Failure (error)

C++

void AMyActor::FlagMessage(const FString& MessageId)
{
    FCometChatFlagDetail FlagDetail;
    FlagDetail.ReasonId = TEXT("spam");
    FlagDetail.Remark = TEXT("This message is spam");

    auto* Action = UCometChatFlagMessageAction::FlagMessage(this, MessageId, FlagDetail);
    Action->OnSuccess.AddDynamic(this, &AMyActor::HandleFlagSuccess);
    Action->OnFailure.AddDynamic(this, &AMyActor::HandleError);
    Action->Activate();
}

void AMyActor::HandleFlagSuccess()
{
    UE_LOG(LogTemp, Log, TEXT("Message flagged successfully"));
}

---

Get Flag Reasons

Fetch the list of available reasons a user can select when flagging a message.

Blueprint

1. Call the Get Flag Reasons Async node (no parameters needed)
2. On Success, iterate the returned TArray<FCometChatFlagReason>
3. Display the reasons in a UI picker for the user to select from

C++

void AMyActor::FetchFlagReasons()
{
    auto* Action = UCometChatGetFlagReasonsAction::GetFlagReasons(this);
    Action->OnSuccess.AddDynamic(this, &AMyActor::HandleFlagReasons);
    Action->OnFailure.AddDynamic(this, &AMyActor::HandleError);
    Action->Activate();
}

void AMyActor::HandleFlagReasons(const TArray<FCometChatFlagReason>& Reasons)
{
    for (const auto& Reason : Reasons)
    {
        UE_LOG(LogTemp, Log, TEXT("Reason: %s — %s"), *Reason.Name, *Reason.Description);
    }
}

---

Moderation Status on Messages

Every FCometChatMessage includes a ModerationStatus field of type ECometChatModerationStatus. Use this to filter or visually indicate moderated content in your UI.

ECometChatModerationStatus

Value	Description
Unmoderated	Message has not been moderated
Pending	Message is pending moderation review
Approved	Message has been approved by moderation
Disapproved	Message has been rejected by moderation

Real-Time Moderation Updates

Listen to the OnMessageModerated delegate to receive real-time updates when a message’s moderation status changes:

Blueprint

Bind to On Message Moderated on the CometChat Subsystem. The event provides the updated FCometChatMessage with the new ModerationStatus.

C++

void AMyActor::BeginPlay()
{
    Super::BeginPlay();

    UCometChatSubsystem* Chat = GetGameInstance()->GetSubsystem<UCometChatSubsystem>();
    Chat->OnMessageModerated.AddDynamic(this, &AMyActor::HandleMessageModerated);
}

void AMyActor::HandleMessageModerated(const FCometChatMessage& Message)
{
    switch (Message.ModerationStatus)
    {
    case ECometChatModerationStatus::Approved:
        UE_LOG(LogTemp, Log, TEXT("Message %s approved"), *Message.Id);
        break;
    case ECometChatModerationStatus::Disapproved:
        UE_LOG(LogTemp, Log, TEXT("Message %s disapproved — hiding"), *Message.Id);
        HideMessage(Message.Id);
        break;
    default:
        break;
    }
}

---

FCometChatFlagDetail

The struct you provide when flagging a message.

Property	Type	Description
ReasonId	FString	ID of the flag reason (from GetFlagReasons)
Remark	FString	Optional free-text remark from the reporter

FCometChatFlagReason

The struct returned when fetching available flag reasons.

Property	Type	Description
Id	FString	Unique reason identifier
Name	FString	Display name (e.g., “Spam”, “Harassment”)
Description	FString	Detailed description of the reason
CreatedAt	int64	Creation timestamp
UpdatedAt	int64	Last update timestamp

---

Next Steps

Real-Time Events

Listen for moderation status changes in real time.

API Reference

Complete reference of all structs and enums.