Group Management

Create groups, manage members, assign roles, and transfer ownership in CometChat Flutter UI Kit.

AI Agent Component Spec

Field	Value
Package	cometchat_chat_uikit
Key components	CometChatGroups, CometChatCreateGroup, CometChatGroupInfo, CometChatAddMembers, CometChatBannedMembers, CometChatTransferOwnership
Init	CometChatUIKit.init(uiKitSettings) then CometChatUIKit.login(uid)
Entry point	Groups tab → create/join group → CometChatGroupInfo for management
Sample app	GitHub
Related	All Guides

Group Management enables users to create groups, join public/password groups, manage members, ban users, update roles, and transfer ownership.

Before starting, complete the Getting Started guide.

---

Components

Component / Class	Role
CometChatGroups	Displays groups and create button
CometChatCreateGroup	UI to create new groups
CometChatGroupInfo	Shows group info and member management
CometChatAddMembers	Add members to a group
CometChatBannedMembers	View/unban banned users
CometChatTransferOwnership	Transfer group ownership
CometChatChangeScope	Change a user’s group role
JoinProtectedGroupUtils	Utility to join password-protected groups

---

Integration Steps

1. Create a Group

Show the create group dialog from the dashboard.

File: dashboard.dart

IconButton(
  onPressed: () {
    showCreateGroup(
      context: context,
      colorPalette: colorPalette,
      typography: typography,
      spacing: spacing,
    );
  },
  icon: Icon(Icons.group_add),
)

File: cometchat_create_group.dart

await CometChat.createGroup(
  group: Group(
    guid: groupId,
    name: groupName,
    type: groupType,
    password: groupPassword,
  ),
  onSuccess: (Group group) => Navigator.pop(context),
  onError: (e) {
    // Show error
  },
);

---

2. Join Public/Password Group

Handle group tap to join or prompt for password.

File: join_protected_group_util.dart

CometChatGroups(
  onItemTap: (context, group) {
    JoinProtectedGroupUtils.onGroupItemTap(context, group);
  },
)

---

3. View Group Info

Display group details and member management options.

File: cometchat_group_info.dart

CometChatGroupInfo(
  group: group,
)

---

4. Add Members

Navigate to add members screen.

File: cometchat_add_members.dart

CometChatAddMembers(
  group: group,
)

---

5. Ban/Unban Members

Manage banned members list.

File: cometchat_banned_members.dart

CometChatBannedMembers(
  group: group,
)

---

6. Transfer Ownership

Transfer group ownership to another member.

File: cometchat_transfer_ownership.dart

CometChatTransferOwnership(
  group: group,
)

---

Feature Matrix

Feature	Component / Method	File
Create group	CometChatCreateGroup	cometchat_create_group.dart
Join group	JoinProtectedGroupUtils	join_protected_group_util.dart
View members	CometChatGroupInfo	cometchat_group_info.dart
Add members	CometChatAddMembers	cometchat_add_members.dart
Ban/unban	CometChatBannedMembers	cometchat_banned_members.dart
Transfer ownership	CometChatTransferOwnership	cometchat_transfer_ownership.dart

---

Next Steps

Groups

Learn more about the Groups component.

Group Members

Display and manage group members.

Conversations

View group conversations.

All Guides

Browse all feature and formatter guides.