Delivery & Read Receipts

Mark messages as delivered, read, or unread and receive real-time receipt events using the CometChat JavaScript SDK.

Quick Reference

Method	Description
markAsDelivered(message)	Mark a message as delivered
markAsRead(message)	Mark a message as read
markConversationAsDelivered(id, type)	Mark entire conversation as delivered
markConversationAsRead(id, type)	Mark entire conversation as read
markMessageAsUnread(message)	Mark a message as unread
getMessageReceipts(messageId)	Get delivery/read receipts for a message

// Mark as delivered/read (pass message object)
CometChat.markAsDelivered(message);
CometChat.markAsRead(message);

// Mark entire conversation
CometChat.markConversationAsRead("UID", "user");

// Listen for receipt events
CometChat.addMessageListener("LISTENER_ID", new CometChat.MessageListener({
  onMessagesDelivered: (receipt) => { },
  onMessagesRead: (receipt) => { },
  onMessagesDeliveredToAll: (receipt) => { },  // Groups only
  onMessagesReadByAll: (receipt) => { }        // Groups only
}));

Delivery and read receipts track whether messages have been delivered to and read by recipients.

Mark as Delivered

Use markAsDelivered() to mark messages as delivered. You can pass either a message object or individual parameters.

Using Message Object

JavaScript

CometChat.markAsDelivered(message).then(
  () => {
    console.log("Marked as delivered successfully");
  },
  (error) => {
    console.log("Error marking as delivered:", error);
  }
);

TypeScript

CometChat.markAsDelivered(message).then(
  () => {
    console.log("Marked as delivered successfully");
  },
  (error: CometChat.CometChatException) => {
    console.log("Error marking as delivered:", error);
  }
);

Using Parameters

Parameter	Description
messageId	ID of the message to mark as delivered
receiverId	For user chats: sender’s UID. For groups: group GUID
receiverType	"user" or "group"
senderId	UID of the message sender

User

let messageId = "MESSAGE_ID";
let receiverId = "MESSAGE_SENDER_UID";
let receiverType = "user";
let senderId = "MESSAGE_SENDER_UID";

CometChat.markAsDelivered(messageId, receiverId, receiverType, senderId).then(
  () => {
    console.log("Marked as delivered successfully");
  },
  (error) => {
    console.log("Error marking as delivered:", error);
  }
);

Group

let messageId = "MESSAGE_ID";
let receiverId = "GROUP_GUID";
let receiverType = "group";
let senderId = "MESSAGE_SENDER_UID";

CometChat.markAsDelivered(messageId, receiverId, receiverType, senderId).then(
  () => {
    console.log("Marked as delivered successfully");
  },
  (error) => {
    console.log("Error marking as delivered:", error);
  }
);

TypeScript (User)

let messageId: string = "MESSAGE_ID";
let receiverId: string = "MESSAGE_SENDER_UID";
let receiverType: string = "user";
let senderId: string = "MESSAGE_SENDER_UID";

CometChat.markAsDelivered(messageId, receiverId, receiverType, senderId).then(
  () => {
    console.log("Marked as delivered successfully");
  },
  (error: CometChat.CometChatException) => {
    console.log("Error marking as delivered:", error);
  }
);

TypeScript (Group)

let messageId: string = "MESSAGE_ID";
let receiverId: string = "GROUP_GUID";
let receiverType: string = "group";
let senderId: string = "MESSAGE_SENDER_UID";

CometChat.markAsDelivered(messageId, receiverId, receiverType, senderId).then(
  () => {
    console.log("Marked as delivered successfully");
  },
  (error: CometChat.CometChatException) => {
    console.log("Error marking as delivered:", error);
  }
);

Mark Conversation as Delivered

Use markConversationAsDelivered() to mark all messages in a conversation as delivered.

User

let conversationWith = "USER_UID";
let conversationType = "user";

CometChat.markConversationAsDelivered(conversationWith, conversationType).then(
  (response) => {
    console.log("Conversation marked as delivered", response);
  },
  (error) => {
    console.log("Error:", error);
  }
);

Group

let conversationWith = "GROUP_GUID";
let conversationType = "group";

CometChat.markConversationAsDelivered(conversationWith, conversationType).then(
  (response) => {
    console.log("Conversation marked as delivered", response);
  },
  (error) => {
    console.log("Error:", error);
  }
);

TypeScript (User)

let conversationWith: string = "USER_UID";
let conversationType: string = "user";

CometChat.markConversationAsDelivered(conversationWith, conversationType).then(
  (response: string) => {
    console.log("Conversation marked as delivered", response);
  },
  (error: CometChat.CometChatException) => {
    console.log("Error:", error);
  }
);

TypeScript (Group)

let conversationWith: string = "GROUP_GUID";
let conversationType: string = "group";

CometChat.markConversationAsDelivered(conversationWith, conversationType).then(
  (response: string) => {
    console.log("Conversation marked as delivered", response);
  },
  (error: CometChat.CometChatException) => {
    console.log("Error:", error);
  }
);

Mark as Read

Use markAsRead() to mark messages as read. You can pass either a message object or individual parameters.

Using Message Object

JavaScript

CometChat.markAsRead(message).then(
  () => {
    console.log("Marked as read successfully");
  },
  (error) => {
    console.log("Error marking as read:", error);
  }
);

TypeScript

CometChat.markAsRead(message).then(
  () => {
    console.log("Marked as read successfully");
  },
  (error: CometChat.CometChatException) => {
    console.log("Error marking as read:", error);
  }
);

Using Parameters

User

let messageId = "MESSAGE_ID";
let receiverId = "MESSAGE_SENDER_UID";
let receiverType = "user";
let senderId = "MESSAGE_SENDER_UID";

CometChat.markAsRead(messageId, receiverId, receiverType, senderId).then(
  () => {
    console.log("Marked as read successfully");
  },
  (error) => {
    console.log("Error marking as read:", error);
  }
);

Group

let messageId = "MESSAGE_ID";
let receiverId = "GROUP_GUID";
let receiverType = "group";
let senderId = "MESSAGE_SENDER_UID";

CometChat.markAsRead(messageId, receiverId, receiverType, senderId).then(
  () => {
    console.log("Marked as read successfully");
  },
  (error) => {
    console.log("Error marking as read:", error);
  }
);

TypeScript (User)

let messageId: string = "MESSAGE_ID";
let receiverId: string = "MESSAGE_SENDER_UID";
let receiverType: string = "user";
let senderId: string = "MESSAGE_SENDER_UID";

CometChat.markAsRead(messageId, receiverId, receiverType, senderId).then(
  () => {
    console.log("Marked as read successfully");
  },
  (error: CometChat.CometChatException) => {
    console.log("Error marking as read:", error);
  }
);

TypeScript (Group)

let messageId: string = "MESSAGE_ID";
let receiverId: string = "GROUP_GUID";
let receiverType: string = "group";
let senderId: string = "MESSAGE_SENDER_UID";

CometChat.markAsRead(messageId, receiverId, receiverType, senderId).then(
  () => {
    console.log("Marked as read successfully");
  },
  (error: CometChat.CometChatException) => {
    console.log("Error marking as read:", error);
  }
);

Mark Conversation as Read

Use markConversationAsRead() to mark all messages in a conversation as read.

User

let conversationWith = "USER_UID";
let conversationType = "user";

CometChat.markConversationAsRead(conversationWith, conversationType).then(
  (response) => {
    console.log("Conversation marked as read", response);
  },
  (error) => {
    console.log("Error:", error);
  }
);

Group

let conversationWith = "GROUP_GUID";
let conversationType = "group";

CometChat.markConversationAsRead(conversationWith, conversationType).then(
  (response) => {
    console.log("Conversation marked as read", response);
  },
  (error) => {
    console.log("Error:", error);
  }
);

TypeScript (User)

let conversationWith: string = "USER_UID";
let conversationType: string = "user";

CometChat.markConversationAsRead(conversationWith, conversationType).then(
  (response: string) => {
    console.log("Conversation marked as read", response);
  },
  (error: CometChat.CometChatException) => {
    console.log("Error:", error);
  }
);

TypeScript (Group)

let conversationWith: string = "GROUP_GUID";
let conversationType: string = "group";

CometChat.markConversationAsRead(conversationWith, conversationType).then(
  (response: string) => {
    console.log("Conversation marked as read", response);
  },
  (error: CometChat.CometChatException) => {
    console.log("Error:", error);
  }
);

Mark as Unread

Use markMessageAsUnread() to mark a message as unread. All messages below that message will contribute to the unread count.

You cannot mark your own messages as unread. This method only works for messages received from other users.

JavaScript

CometChat.markMessageAsUnread(message).then(
  (conversation) => {
    console.log("Marked as unread successfully", conversation);
    console.log("Unread count:", conversation.getUnreadMessageCount());
  },
  (error) => {
    console.log("Error marking as unread:", error);
  }
);

TypeScript

CometChat.markMessageAsUnread(message).then(
  (conversation: CometChat.Conversation) => {
    console.log("Marked as unread successfully", conversation);
    console.log("Unread count:", conversation.getUnreadMessageCount());
  },
  (error: CometChat.CometChatException) => {
    console.log("Error marking as unread:", error);
  }
);

On success, returns an updated Conversation object with the new unread message count.

Real-Time Receipt Events

Register a MessageListener to receive delivery and read receipt events.

Callback	Description
onMessagesDelivered	Message delivered to a user
onMessagesRead	Message read by a user
onMessagesDeliveredToAll	Group message delivered to all members
onMessagesReadByAll	Group message read by all members

JavaScript

let listenerID = "UNIQUE_LISTENER_ID";

CometChat.addMessageListener(
  listenerID,
  new CometChat.MessageListener({
    onMessagesDelivered: (messageReceipt) => {
      console.log("Message delivered:", messageReceipt);
    },
    onMessagesRead: (messageReceipt) => {
      console.log("Message read:", messageReceipt);
    },
    onMessagesDeliveredToAll: (messageReceipt) => {
      console.log("Message delivered to all group members:", messageReceipt);
    },
    onMessagesReadByAll: (messageReceipt) => {
      console.log("Message read by all group members:", messageReceipt);
    }
  })
);

TypeScript

let listenerID: string = "UNIQUE_LISTENER_ID";

CometChat.addMessageListener(
  listenerID,
  new CometChat.MessageListener({
    onMessagesDelivered: (messageReceipt: CometChat.MessageReceipt) => {
      console.log("Message delivered:", messageReceipt);
    },
    onMessagesRead: (messageReceipt: CometChat.MessageReceipt) => {
      console.log("Message read:", messageReceipt);
    },
    onMessagesDeliveredToAll: (messageReceipt: CometChat.MessageReceipt) => {
      console.log("Message delivered to all group members:", messageReceipt);
    },
    onMessagesReadByAll: (messageReceipt: CometChat.MessageReceipt) => {
      console.log("Message read by all group members:", messageReceipt);
    }
  })
);

Always remove listeners when no longer needed to prevent memory leaks.

CometChat.removeMessageListener("UNIQUE_LISTENER_ID");

MessageReceipt Object

The listener callbacks receive a MessageReceipt object:

Field	Getter	Return Type	Description
messageId	getMessageId()	string	ID of the message
sender	getSender()	User	User who triggered the receipt
receiverId	getReceiverId()	string	ID of the receiver
receiverType	getReceiverType()	string	"user" or "group"
receiptType	getReceiptType()	string	"delivery" or "read"
deliveredAt	getDeliveredAt()	number	Timestamp when delivered
readAt	getReadAt()	number	Timestamp when read

Get Receipt History

Use getMessageReceipts() to fetch delivery and read receipts for a specific message. Useful for group messages to see which members have received/read the message.

JavaScript

let messageId = 123;

CometChat.getMessageReceipts(messageId).then(
  (receipts) => {
    console.log("Message receipts:", receipts);
  },
  (error) => {
    console.log("Error fetching receipts:", error);
  }
);

TypeScript

let messageId: number = 123;

CometChat.getMessageReceipts(messageId).then(
  (receipts: CometChat.MessageReceipt[]) => {
    console.log("Message receipts:", receipts);
  },
  (error: CometChat.CometChatException) => {
    console.log("Error fetching receipts:", error);
  }
);

Returns an array of MessageReceipt objects.

Missed Receipts

When fetching messages, each message object includes deliveredAt and readAt timestamps indicating when the message was delivered and read.

let deliveredAt = message.getDeliveredAt();
let readAt = message.getReadAt();

The following features require Enhanced Messaging Status to be enabled for your app:

• onMessagesDeliveredToAll event
• onMessagesReadByAll event
• deliveredAt field in group messages
• readAt field in group messages
• markMessageAsUnread() method

---

Next Steps

Typing Indicators

Show real-time typing status in conversations

Receive Messages

Listen for incoming messages in real time

Retrieve Conversations

Fetch conversation list with unread counts

All Real-Time Listeners

Complete reference for all SDK event listeners