Leave A Group

Learn how to leave a group and receive real-time events when members leave using the CometChat JavaScript SDK.

AI Integration Quick Reference

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

// Listen for member left events
CometChat.addGroupListener("listener", new CometChat.GroupListener({
  onGroupMemberLeft: (message, leavingUser, group) => { }
}));

Leave a group to stop receiving messages and updates from it. Once you leave, you’ll need to rejoin to participate again.

Group owners cannot leave without first transferring ownership to another member. See Transfer Group Ownership.

Leave a Group

Use leaveGroup() to leave a group.

TypeScript

const GUID: string = "GUID";

CometChat.leaveGroup(GUID).then(
  (hasLeft: boolean) => {
      console.log("Group left successfully:", hasLeft);
  }, (error: CometChat.CometChatException) => {
      console.log("Group leaving failed with exception:", error);
  }
);

JavaScript

const GUID = "GUID";

CometChat.leaveGroup(GUID).then(
hasLeft => {
  console.log("Group left successfully:", hasLeft);
}, error => {
  console.log("Group leaving failed with exception:", error);
}
);

Parameter	Description
GUID	The GUID of the group you would like to leave

Once a group is left, the user will no longer receive any updates or messages pertaining to the group.

On success, the method resolves with true (boolean).

Real-time Group Member Left Events

Register a GroupListener to receive events when members leave.

TypeScript

CometChat.addGroupListener(
  "UNIQUE_LISTENER_ID",
  new CometChat.GroupListener({
      onGroupMemberLeft: (message: CometChat.Action, leavingUser: CometChat.User, group: CometChat.Group) => {
          console.log("User left", { message, leavingUser, group });
      }
  })
);

JavaScript

CometChat.addGroupListener(
  "UNIQUE_LISTENER_ID",
  new CometChat.GroupListener({
      onGroupMemberLeft: (message, leavingUser, group) => {
          console.log("User left", { message, leavingUser, group });
      }
  })
);

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

CometChat.removeGroupListener("UNIQUE_LISTENER_ID");

Missed Group Member Left Events

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

• action — "left"
• actionBy — User who left
• actionFor — Group that was left

---

Next Steps

Join a Group

Join public or password-protected groups

Delete a Group

Permanently delete a group

Kick & Ban Members

Remove or ban members from a group

Retrieve Groups

Fetch and filter the list of groups