Delete A Message

Learn how to delete messages, listen for real-time message delete events, and retrieve missed message deletions using the CometChat React Native SDK.

Quick Reference for AI Agents & Developers

// Delete a message by ID
let messageId = "MESSAGE_ID";
CometChat.deleteMessage(messageId).then(
  (message) => console.log("Message deleted", message),
  (error) => console.log("Delete failed:", error)
);

// Listen for real-time message deletes
CometChat.addMessageListener("LISTENER_ID", new CometChat.MessageListener({
  onMessageDeleted: (message) => console.log("Deleted:", message)
}));

While deleting a message is straightforward, receiving events for deleted messages with CometChat has two parts:

1. Adding a listener to receive real-time message deletes when your app is running.
2. Calling a method to retrieve missed message deletes when your app was not running.

Available via: SDK | REST API | UI Kits

Delete a Message

In other words, as a sender, how do I delete a message?

To delete a message, use the deleteMessage() method. This method takes the message ID of the message to be deleted.

This operation is irreversible. Deleted messages cannot be recovered.

JavaScript

let messageId = "ID_OF_THE_MESSAGE_YOU_WANT_TO_DELETE";

CometChat.deleteMessage(messageId).then(
message => {
  console.log("Message deleted", message);
}, error => {
  console.log("Message delete failed with error:", error);
}
);

TypeScript

let messageId: number = 1;

CometChat.deleteMessage(messageId).then(
  (message: CometChat.BaseMessage) => {
      console.log("Message deleted", message);
  }, (error: CometChat.CometChatException) => {
      console.log("Message delete failed with error:", error);
  }
);

Response

On Success — deleteMessage() returns the deleted message object with deletedAt and deletedBy fields set:

Message Object:

Parameter	Type	Description	Sample Value
id	string	Unique message identifier	"25305"
conversationId	string	Conversation identifier	"cometchat-uid-6_user_cometchat-uid-7"
receiverId	string	Receiver’s UID	"cometchat-uid-6"
receiverType	string	Type of receiver	"user"
type	string	Message type	"text"
category	string	Message category	"message"
sentAt	number	Unix timestamp when originally sent	1771996215
deliveredAt	number	Unix timestamp when delivered	1771996215
readAt	number	Unix timestamp when read	1771996215
deletedAt	number	Unix timestamp when deleted	1771996222
deletedBy	string	UID of user who deleted the message	"cometchat-uid-7"
updatedAt	number	Unix timestamp when updated	1771996222
sender	object	Sender user details	See below ↓
receiver	object	Receiver user details	See below ↓
data	object	Additional message data	See below ↓
reactions	array	Message reactions	[]
mentionedUsers	array	Users mentioned in message	[]
mentionedMe	boolean	Whether current user is mentioned	false

---

sender Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-7"
name	string	User’s display name	"Henry Marino"
avatar	string	URL to user’s avatar	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-7.webp"
status	string	User’s online status	"offline"
role	string	User’s role	"default"
lastActiveAt	number	Last active timestamp	1771993054
hasBlockedMe	boolean	Whether user has blocked current user	false
blockedByMe	boolean	Whether current user blocked this user	false
deactivatedAt	number	Deactivation timestamp (0 if active)	0
tags	array	User tags	[]

---

receiver Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-6"
name	string	User’s display name	"Ronald Jerry"
avatar	string	URL to user’s avatar	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-6.webp"
status	string	User’s online status	"offline"
role	string	User’s role	"default"
lastActiveAt	number	Last active timestamp	1771994056
hasBlockedMe	boolean	Whether user has blocked current user	false
blockedByMe	boolean	Whether current user blocked this user	false
deactivatedAt	number	Deactivation timestamp (0 if active)	0
tags	array	User tags	[]

---

data Object:

Parameter	Type	Description	Sample Value
entities	object	Sender and receiver entities	See below ↓

---

data.entities Object:

Parameter	Type	Description	Sample Value
sender	object	Sender entity wrapper	See below ↓
receiver	object	Receiver entity wrapper	See below ↓

---

data.entities.sender Object:

Parameter	Type	Description	Sample Value
entityType	string	Type of entity	"user"
entity	object	User entity details	See below ↓

---

data.entities.sender.entity Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-7"
name	string	User’s display name	"Henry Marino"
avatar	string	User’s avatar URL	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-7.webp"
role	string	User’s role	"default"
status	string	User’s online status	"offline"
lastActiveAt	number	Last active timestamp	1771993054
tags	array	User tags	[]

---

data.entities.receiver Object:

Parameter	Type	Description	Sample Value
entityType	string	Type of entity	"user"
entity	object	User entity details	See below ↓

---

data.entities.receiver.entity Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-6"
name	string	User’s display name	"Ronald Jerry"
avatar	string	User’s avatar URL	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-6.webp"
role	string	User’s role	"default"
status	string	User’s online status	"offline"
lastActiveAt	number	Last active timestamp	1771994056
conversationId	string	Conversation identifier	"cometchat-uid-6_user_cometchat-uid-7"
tags	array	User tags	[]

Once the message is deleted, in the onSuccess() callback, you get an object of the BaseMessage class, with the deletedAt field set with the timestamp of the time the message was deleted. Also, the deletedBy field is set. These two fields can be used to identify if the message is deleted while iterating through a list of messages.

By default, CometChat allows certain roles to delete a message.

User Role	Conversation Type	Deletion Capabilities
Message Sender	One-on-One Conversation	Messages they have sent.
Message Sender	Group Conversation	Messages they have sent.
Group Admin	Group Conversation	All the messages in the group.
Group Moderator	Group Conversation	All the messages in the group.

Real-time Message Delete Events

In other words, as a recipient, how do I know when someone deletes a message when my app is running?

In order to receive real-time events for a message being deleted, you need to override the onMessageDeleted() method of the MessageListener class.

JavaScript

var listenerID = "UNIQUE_LISTENER_ID";

CometChat.addMessageListener(
listenerID,
new CometChat.MessageListener({
  onMessageDeleted: message => {
    console.log("Deleted Message", message);
  }
})
);

TypeScript

let listenerID: string = "UNIQUE_LISTENER_ID";

CometChat.addMessageListener(
  listenerID,
  new CometChat.MessageListener({
      onMessageDeleted: (message: CometChat.BaseMessage) => {
          console.log("Deleted Message", message);
      }
  })
);

Response

On Event — onMessageDeleted callback receives the deleted message object:

Message Object:

Parameter	Type	Description	Sample Value
id	string	Unique message identifier	"25301"
conversationId	string	Conversation identifier	"cometchat-uid-6_user_cometchat-uid-7"
receiverId	string	Receiver’s UID	"cometchat-uid-7"
receiverType	string	Type of receiver	"user"
type	string	Message type	"text"
category	string	Message category	"message"
sentAt	number	Unix timestamp when originally sent	1771996032
deliveredAt	number	Unix timestamp when delivered	1771996033
readAt	number	Unix timestamp when read	1771996033
deletedAt	number	Unix timestamp when deleted	1771996040
deletedBy	string	UID of user who deleted the message	"cometchat-uid-6"
updatedAt	number	Unix timestamp when updated	1771996040
sender	object	Sender user details	See below ↓
receiver	object	Receiver user details	See below ↓
data	object	Additional message data	See below ↓
reactions	array	Message reactions	[]
mentionedUsers	array	Users mentioned in message	[]
mentionedMe	boolean	Whether current user is mentioned	false

---

sender Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-6"
name	string	User’s display name	"Ronald Jerry"
avatar	string	URL to user’s avatar	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-6.webp"
status	string	User’s online status	"offline"
role	string	User’s role	"default"
lastActiveAt	number	Last active timestamp	1771994056
hasBlockedMe	boolean	Whether user has blocked current user	false
blockedByMe	boolean	Whether current user blocked this user	false
deactivatedAt	number	Deactivation timestamp (0 if active)	0
tags	array	User tags	[]

---

receiver Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-7"
name	string	User’s display name	"Henry Marino"
avatar	string	URL to user’s avatar	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-7.webp"
status	string	User’s online status	"offline"
role	string	User’s role	"default"
lastActiveAt	number	Last active timestamp	1771993054
hasBlockedMe	boolean	Whether user has blocked current user	false
blockedByMe	boolean	Whether current user blocked this user	false
deactivatedAt	number	Deactivation timestamp (0 if active)	0
tags	array	User tags	[]

---

data Object:

Parameter	Type	Description	Sample Value
entities	object	Sender and receiver entities	See below ↓

---

data.entities Object:

Parameter	Type	Description	Sample Value
sender	object	Sender entity wrapper	See below ↓
receiver	object	Receiver entity wrapper	See below ↓

---

data.entities.sender Object:

Parameter	Type	Description	Sample Value
entityType	string	Type of entity	"user"
entity	object	User entity details	See below ↓

---

data.entities.sender.entity Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-6"
name	string	User’s display name	"Ronald Jerry"
avatar	string	User’s avatar URL	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-6.webp"
role	string	User’s role	"default"
status	string	User’s online status	"offline"
lastActiveAt	number	Last active timestamp	1771994056
tags	array	User tags	[]

---

data.entities.receiver Object:

Parameter	Type	Description	Sample Value
entityType	string	Type of entity	"user"
entity	object	User entity details	See below ↓

---

data.entities.receiver.entity Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-7"
name	string	User’s display name	"Henry Marino"
avatar	string	User’s avatar URL	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-7.webp"
role	string	User’s role	"default"
status	string	User’s online status	"offline"
lastActiveAt	number	Last active timestamp	1771993054
conversationId	string	Conversation identifier	"cometchat-uid-6_user_cometchat-uid-7"
tags	array	User tags	[]

Always remove listeners when they are no longer needed (e.g., on component unmount or screen navigation). Failing to remove listeners can cause memory leaks and duplicate event handling.

CometChat.removeMessageListener("UNIQUE_LISTENER_ID");

Missed Message Delete Events

In other words, as a recipient, how do I know if someone deleted a message when my app was not running?

When you retrieve the list of previous messages, for the messages that were deleted, the deletedAt and the deletedBy fields will be set. Also, for example, of the total number of messages for a conversation are 100, and the message with message ID 50 was deleted. Now the message with id 50 will have the deletedAt and the deletedBy fields set whenever it is pulled from the history. Also, the 101st message will be an Action message informing you that the message with id 50 has been deleted.

Response

When fetching message history — deleted messages have deletedAt and deletedBy fields set:

Message Object (per item in array):

Parameter	Type	Description	Sample Value
id	string	Unique message identifier	"25301"
conversationId	string	Conversation identifier	"cometchat-uid-6_user_cometchat-uid-7"
receiverId	string	Receiver’s UID	"cometchat-uid-7"
receiverType	string	Type of receiver	"user"
type	string	Message type	"text"
category	string	Message category	"message"
sentAt	number	Unix timestamp when originally sent	1771996032
deliveredAt	number	Unix timestamp when delivered	1771996033
readAt	number	Unix timestamp when read	1771996033
deletedAt	number	Unix timestamp when deleted	1771996040
deletedBy	string	UID of user who deleted the message	"cometchat-uid-6"
updatedAt	number	Unix timestamp when updated	1771996040
sender	object	Sender user details	See below ↓
receiver	object	Receiver user details	See below ↓
data	object	Additional message data	See below ↓
reactions	array	Message reactions	[]
mentionedUsers	array	Users mentioned in message	[]
mentionedMe	boolean	Whether current user is mentioned	false

---

sender Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-6"
name	string	User’s display name	"Ronald Jerry"
avatar	string	URL to user’s avatar	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-6.webp"
status	string	User’s online status	"offline"
role	string	User’s role	"default"
lastActiveAt	number	Last active timestamp	1771994056
hasBlockedMe	boolean	Whether user has blocked current user	false
blockedByMe	boolean	Whether current user blocked this user	false
deactivatedAt	number	Deactivation timestamp (0 if active)	0
tags	array	User tags	[]

---

receiver Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-7"
name	string	User’s display name	"Henry Marino"
avatar	string	URL to user’s avatar	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-7.webp"
status	string	User’s online status	"offline"
role	string	User’s role	"default"
lastActiveAt	number	Last active timestamp	1771993054
hasBlockedMe	boolean	Whether user has blocked current user	false
blockedByMe	boolean	Whether current user blocked this user	false
deactivatedAt	number	Deactivation timestamp (0 if active)	0
tags	array	User tags	[]

---

data Object:

Parameter	Type	Description	Sample Value
entities	object	Sender and receiver entities	See below ↓

---

data.entities Object:

Parameter	Type	Description	Sample Value
sender	object	Sender entity wrapper	See below ↓
receiver	object	Receiver entity wrapper	See below ↓

---

data.entities.sender Object:

Parameter	Type	Description	Sample Value
entityType	string	Type of entity	"user"
entity	object	User entity details	See below ↓

---

data.entities.sender.entity Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-6"
name	string	User’s display name	"Ronald Jerry"
avatar	string	User’s avatar URL	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-6.webp"
role	string	User’s role	"default"
status	string	User’s online status	"offline"
lastActiveAt	number	Last active timestamp	1771994056
tags	array	User tags	[]

---

data.entities.receiver Object:

Parameter	Type	Description	Sample Value
entityType	string	Type of entity	"user"
entity	object	User entity details	See below ↓

---

data.entities.receiver.entity Object:

Parameter	Type	Description	Sample Value
uid	string	User’s unique identifier	"cometchat-uid-7"
name	string	User’s display name	"Henry Marino"
avatar	string	User’s avatar URL	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-7.webp"
role	string	User’s role	"default"
status	string	User’s online status	"offline"
lastActiveAt	number	Last active timestamp	1771993054
conversationId	string	Conversation identifier	"cometchat-uid-6_user_cometchat-uid-7"
tags	array	User tags	[]

For the message deleted event, in the Action object received, the following fields can help you get the relevant information-

1. action - deleted
2. actionOn - Updated message object which was deleted.
3. actionBy - User object containing the details of the user who has deleted the message.
4. actionFor - User/group object having the details of the receiver to which the message was sent.

When fetching message history, deleted messages include deletedAt and deletedBy fields. You can check if deletedAt is set to identify deleted messages. Additionally, an Action message with action: "deleted" is added to the message list for audit/timeline purposes.

In order to edit or delete a message, you need to be either the sender of the message or the admin/moderator of the group in which the message was sent.

Best Practices

• Check deletedAt when rendering messages. Before displaying a message, check if deletedAt is set. If it is, show a “This message was deleted” placeholder instead of the original content.
• Use unique listener IDs. Use a unique identifier per screen or component (e.g., "ChatScreen_DeleteListener") to avoid conflicts with other listeners.
• Always clean up listeners. Remove message listeners in your component’s cleanup or unmount lifecycle to prevent memory leaks.
• Handle permissions gracefully. If a user attempts to delete a message they don’t have permission to delete, handle the error callback and inform the user.

Troubleshooting

• “Message delete failed” error: Verify that the message ID is valid and that the current user has permission to delete the message (sender, group admin, or group moderator).
• onMessageDeleted not firing: Ensure you have registered the MessageListener with CometChat.addMessageListener() before the delete event occurs, and that the listener ID is unique.
• Deleted messages still showing in the UI: Make sure you are checking the deletedAt field on each message when rendering your message list, and updating your local state when onMessageDeleted fires.
• Duplicate delete events: This usually happens when multiple listeners are registered with the same or different IDs without being removed. Ensure you remove listeners on component unmount.

---

Next Steps

Edit a Message

Modify the content of a sent message

Send Messages

Send text, media, and custom messages

Receive Messages

Listen for and retrieve incoming messages

Flag a Message

Report inappropriate or unwanted messages