Save A Message

Saving bookmarks a message for the logged-in user. Unlike a pin, a save is private and cross-conversation: nobody else can see it, no role is required, and the saved list spans every conversation the user is part of.

savedAt is per-viewer. It is only ever populated in the acting user’s own context — you will never see another user’s saves on a message.

Call saveMessage() with the message’s ID. It resolves with the full updated message, with savedAt set.

TypeScript
JavaScript

let messageId: number = 100;

CometChat.saveMessage(messageId).then(
  (message: CometChat.BaseMessage) => {
    console.log("Message saved:", message);
  },
  (error: CometChat.CometChatException) => {
    console.log("Failed to save message:", error);
  }
);

let messageId = 100;

CometChat.saveMessage(messageId).then(
  (message) => {
    console.log("Message saved:", message);
  },
  (error) => {
    console.log("Failed to save message:", error);
  }
);

Saving is idempotent — saving an already saved message succeeds rather than failing.

Unsave a Message

TypeScript
JavaScript

CometChat.unsaveMessage(100).then(
  (message: CometChat.BaseMessage) => {
    console.log("Message unsaved:", message);
  },
  (error: CometChat.CometChatException) => {
    console.log("Failed to unsave message:", error);
  }
);

CometChat.unsaveMessage(100).then(
  (message) => {
    console.log("Message unsaved:", message);
  },
  (error) => {
    console.log("Failed to unsave message:", error);
  }
);

The resolved message comes back with savedAt cleared, never left stale.

Fetch Saved Messages

Build a MessagesRequest with setSaved(true). The saved list is user-level, so unlike the pinned list you do not set a UID or a GUID — leaving both unset is what makes it cross-conversation.

TypeScript
JavaScript

let messagesRequest: CometChat.MessagesRequest =
  new CometChat.MessagesRequestBuilder()
    .setSaved(true)
    .setLimit(50)
    .build();

messagesRequest.fetchPrevious().then(
  (messages: CometChat.BaseMessage[]) => {
    console.log("Saved messages:", messages);
  },
  (error: CometChat.CometChatException) => {
    console.log("Failed to fetch saved messages:", error);
  }
);

let messagesRequest = new CometChat.MessagesRequestBuilder()
  .setSaved(true)
  .setLimit(50)
  .build();

messagesRequest.fetchPrevious().then(
  (messages) => {
    console.log("Saved messages:", messages);
  },
  (error) => {
    console.log("Failed to fetch saved messages:", error);
  }
);

The list comes back newest message first. Call fetchPrevious() again on the same object to page through older entries. Because the list spans conversations, every row carries its own context — use getConversationId(), getReceiverId() and getReceiverType() to route a tap on a saved message back to the right conversation.

TypeScript
JavaScript

messages.forEach((message: CometChat.BaseMessage) => {
  console.log(
    message.getConversationId(),
    message.getReceiverType(), // "user" or "group"
    message.getReceiverId()
  );
});

messages.forEach((message) => {
  console.log(
    message.getConversationId(),
    message.getReceiverType(), // "user" or "group"
    message.getReceiverId()
  );
});

Check if a Message is Saved

The presence of savedAt is the boolean — an unsaved message simply has no save attribute.

TypeScript
JavaScript

if (message.isSaved()) {
  console.log("Saved at:", message.getSavedAt());
}

if (message.isSaved()) {
  console.log("Saved at:", message.getSavedAt());
}

Method	Returns
`isSaved()`	`true` when the logged-in user saved it.
`getSavedAt()`	The save timestamp, or `undefined`.

Real-time Save Events

Save and unsave are private multi-device events: they are delivered to the user’s other logged-in sessions so a save on the phone shows up on the desktop. Add the callbacks to your existing MessageListener.

TypeScript
JavaScript

CometChat.addMessageListener(
  "UNIQUE_LISTENER_ID",
  new CometChat.MessageListener({
    onMessageSaved: (message: CometChat.BaseMessage) => {
      console.log("Message saved:", message);
    },
    onMessageUnsaved: (message: CometChat.BaseMessage) => {
      console.log("Message unsaved:", message);
    },
  })
);

CometChat.addMessageListener(
  "UNIQUE_LISTENER_ID",
  new CometChat.MessageListener({
    onMessageSaved: (message) => {
      console.log("Message saved:", message);
    },
    onMessageUnsaved: (message) => {
      console.log("Message unsaved:", message);
    },
  })
);

These callbacks fire for saves made on your other devices, not the one that performed the save — that device already has the message resolved from saveMessage(). Update your saved list from the promise there, and from these callbacks everywhere else.

Save Limit

A user may save a capped number of messages across all conversations. Read the cap from app settings rather than hard-coding it.

TypeScript
JavaScript

let limit: number | null = await CometChat.getSavedMessagesLimit();

if (limit !== null && savedCount >= limit) {
  // Disable the save control instead of letting the user hit the error
}

CometChat.getSavedMessagesLimit().then((limit) => {
  if (limit !== null && savedCount >= limit) {
    // Disable the save control instead of letting the user hit the error
  }
});

It resolves to null when the app settings carry no value — show generic copy in that case rather than guessing a number.

Feature Availability

TypeScript
JavaScript

let enabled: boolean = await CometChat.isSaveMessageEnabled();

if (enabled) {
  // Show the Save option
}

CometChat.isSaveMessageEnabled().then((enabled) => {
  if (enabled) {
    // Show the Save option
  }
});

This resolves false rather than rejecting when the flag is missing or settings are unavailable.

Next Steps

Pin A Message

Highlight a message for everyone in a conversation

Pin A Conversation

Pin a conversation to the top of the list

Retrieve Conversations

Fetch and order the conversation list

Additional Message Filtering

Filter messages by saved, pinned, type, tags and more

​Save a Message

​Unsave a Message

​Fetch Saved Messages

​Check if a Message is Saved

​Real-time Save Events

​Save Limit

​Feature Availability

​Next Steps

Pin A Message

Pin A Conversation

Retrieve Conversations

Additional Message Filtering

Save a Message

Unsave a Message

Fetch Saved Messages

Check if a Message is Saved

Real-time Save Events

Save Limit

Feature Availability

Next Steps