Leave A Group

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

AI Integration Quick Reference

Field	Value
Package	@cometchat/chat-sdk-react-native
Import	import { CometChat } from "@cometchat/chat-sdk-react-native";
Key Methods	addGroupListener(), leaveGroup(), removeGroupListener()
Key Classes	Action, CometChatException, Group, GroupListener, User
Prerequisites	SDK initialized via CometChat.init() and a logged-in user via CometChat.login()
Primary output	Promise<boolean> — true on success; rejects with CometChatException
Constraints	The owner cannot leave without transferring ownership first. Every add*Listener() needs a matching remove*Listener() with the same listener ID — unremoved listeners leak and fire after unmount.
Related	Join a Group · Transfer Ownership · Delete a Group
Full reference	Group · CometChatException

// 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

With offline support enabled, leaving a group clears that group’s conversation and cached messages from the on-device cache. Any messages still queued to it are dropped and reported as failed with reason DISCARDED. See Send While Offline.

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