Leave a Group

Leave a group to stop receiving messages and updates

Quick Reference for AI Agents & Developers

// Leave a group
await CometChat.leaveGroup("group_guid");

// Listen for leave events
CometChat.addGroupListener("GROUP_LISTENER", new CometChat.GroupListener({
  onGroupMemberLeft: (message, leftUser, group) => {
    console.log(leftUser.getName(), "left", group.getName());
  }
}));

// Note: Transfer ownership first if you're the only admin

Leave a group when you no longer want to participate in the conversation.

Availability: SDK, API, UI Kits

After leaving, you won’t receive messages or updates from the group.

---

Leave a Group

JavaScript

const GUID = "group-123";

CometChat.leaveGroup(GUID).then(
  (hasLeft) => console.log("Left group:", hasLeft),
  (error) => console.log("Failed to leave:", error)
);

TypeScript

const GUID: string = "group-123";

CometChat.leaveGroup(GUID).then(
  (hasLeft: boolean) => console.log("Left group:", hasLeft),
  (error: CometChat.CometChatException) => console.log("Failed:", error)
);

Async/Await

const leaveGroup = async () => {
  try {
    const GUID = "group-123";
    const hasLeft = await CometChat.leaveGroup(GUID);
    console.log("Left group:", hasLeft);
  } catch (error) {
    console.log("Failed to leave:", error);
  }
};

If you’re the only admin, you should transfer ownership before leaving. Otherwise, the group may become unmanageable.

---

Real-Time Leave Events

Listen for when users leave groups you’re a member of:

const listenerID = "GROUP_LISTENER";

CometChat.addGroupListener(
  listenerID,
  new CometChat.GroupListener({
    onGroupMemberLeft: (message, leftUser, group) => {
      console.log(`${leftUser.getName()} left ${group.getName()}`);
    }
  })
);

// Remove listener when done
CometChat.removeGroupListener(listenerID);

---

Missed Leave Events

When fetching message history, leave events appear as Action messages:

messages.forEach((message) => {
  if (message.getCategory() === "action") {
    const action = message.getAction();
    if (action === "left") {
      const user = message.getActionBy();
      console.log(`${user.getName()} left the group`);
    }
  }
});

---

Next Steps

Join Group

Join a group

Delete Group

Delete a group (admin only)