Change Member Scope

Learn how to change group member scope (admin, moderator, participant) and receive real-time scope change events using the CometChat JavaScript SDK.

AI Integration Quick Reference

// Change member scope to admin
await CometChat.updateGroupMemberScope("GUID", "UID", CometChat.GROUP_MEMBER_SCOPE.ADMIN);

// Listen for scope change events
CometChat.addGroupListener("listener", new CometChat.GroupListener({
  onGroupMemberScopeChanged: (message, changedUser, newScope, oldScope, changedGroup) => { }
}));

Promote or demote group members between admin, moderator, and participant scopes. Only admins can change member scopes, and only the group owner can change admin scopes.

Change Scope of a Group Member

Use updateGroupMemberScope() to change a member’s scope within a Group.

TypeScript

let GUID: string = "GUID";
let UID: string = "UID";


CometChat.updateGroupMemberScope(GUID, UID, CometChat.GROUP_MEMBER_SCOPE.ADMIN).then(
  (response: boolean) => {
      console.log("Group member scope changed", response);
  }, (error: CometChat.CometChatException) => {
      console.log("Group member scope change failed", error);
  }
);

JavaScript

let GUID = "GUID";
let UID = "UID";
let scope = CometChat.GROUP_MEMBER_SCOPE.ADMIN;

CometChat.updateGroupMemberScope(GUID, UID, scope).then(
response => {
  console.log("Group member scope changed", response);
}, error => {
  console.log("Group member scope change failed", error);
}
);

This method takes the below parameters:

Parameter	Description
UID	The UID of the member whose scope you want to change
GUID	The GUID of the group
scope	The new scope: CometChat.GROUP_MEMBER_SCOPE.ADMIN, CometChat.GROUP_MEMBER_SCOPE.MODERATOR, or CometChat.GROUP_MEMBER_SCOPE.PARTICIPANT

The default scope is participant. Only Admins can change member scopes.

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

Real-Time Group Member Scope Changed Events

Implement onGroupMemberScopeChanged() in GroupListener to receive real-time notifications when a member’s scope changes.

TypeScript

let listenerID: string = "UNIQUE_LISTENER_ID";

CometChat.addGroupListener(
  listenerID,
  new CometChat.GroupListener({
      onGroupMemberScopeChanged: (message: CometChat.Action, changedUser: CometChat.User, newScope: string, oldScope: string, changedGroup: CometChat.Group) => {
          console.log("Scope changed", { message, changedUser, newScope, oldScope, changedGroup });
      }
  })
);

JavaScript

let listenerID = "UNIQUE_LISTENER_ID";

CometChat.addGroupListener(
listenerID,
new CometChat.GroupListener({
  onGroupMemberScopeChanged: (message, changedUser, newScope, oldScope, changedGroup) => {
    console.log("Scope changed", {message, changedUser, newScope, oldScope, changedGroup});
  }
})
);

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 Scope Changed Events

When fetching previous messages, scope changes appear as Action messages (a subclass of BaseMessage).

Field	Value/Type	Description
action	"scopeChanged"	The action type
actionOn	User	The user whose scope changed
actionBy	User	The user who changed the scope
actionFor	Group	The group
oldScope	string	The previous scope
newScope	string	The new scope

---

Next Steps

Transfer Group Ownership

Transfer ownership of a group to another member

Kick & Ban Members

Remove or ban members from a group

Add Members

Add new members to a group

Retrieve Group Members

Fetch the list of members in a group