Group Members

Scrollable list of all members in a group with search, avatars, names, scope badges, and online/offline status.

AI Agent Component Spec

{
  "component": "CometChatGroupMembers",
  "package": "com.cometchat.chatuikit.groupmembers",
  "xmlElement": "<com.cometchat.chatuikit.groupmembers.CometChatGroupMembers />",
  "description": "Scrollable list of all members in a group with search, avatars, names, scope badges, and online/offline status indicators. Requires a Group object to be set via setGroup().",
  "primaryOutput": {
    "method": "setOnItemClick",
    "type": "OnItemClick<GroupMember>"
  },
  "methods": {
    "data": {
      "setGroup": {
        "type": "Group",
        "required": true,
        "note": "Must be called before the component can load data"
      },
      "setGroupMembersRequestBuilder": {
        "type": "GroupMembersRequest.GroupMembersRequestBuilder",
        "default": "SDK default",
        "note": "Pass the builder, not the result of .build()"
      },
      "setSearchRequestBuilder": {
        "type": "GroupMembersRequest.GroupMembersRequestBuilder",
        "default": "Same as main builder",
        "note": "Separate builder for search results"
      }
    },
    "callbacks": {
      "setOnItemClick": "OnItemClick<GroupMember>",
      "setOnItemLongClick": "OnItemLongClick<GroupMember>",
      "setOnBackPressListener": "OnBackPress",
      "setOnSelection": "OnSelection<GroupMember>",
      "setOnError": "OnError",
      "setOnLoadMore": "OnLoad<GroupMember>",
      "setOnEmpty": "OnEmpty"
    },
    "visibility": {
      "setBackIconVisibility": { "type": "int (View.VISIBLE | View.GONE)", "default": "View.GONE" },
      "setToolbarVisibility": { "type": "int", "default": "View.VISIBLE" },
      "setLoadingStateVisibility": { "type": "int", "default": "View.VISIBLE" },
      "setErrorStateVisibility": { "type": "int", "default": "View.VISIBLE" },
      "setEmptyStateVisibility": { "type": "int", "default": "View.VISIBLE" },
      "setSeparatorVisibility": { "type": "int", "default": "View.VISIBLE" },
      "setUserStatusVisibility": { "type": "int", "default": "View.VISIBLE" },
      "setSearchBoxVisibility": { "type": "int", "default": "View.VISIBLE" },
      "setKickMemberOptionVisibility": { "type": "int", "default": "View.VISIBLE" },
      "setBanMemberOptionVisibility": { "type": "int", "default": "View.VISIBLE" },
      "setScopeChangeOptionVisibility": { "type": "int", "default": "View.VISIBLE" }
    },
    "selection": {
      "setSelectionMode": {
        "type": "UIKitConstants.SelectionMode",
        "values": ["NONE", "SINGLE", "MULTIPLE"],
        "default": "NONE"
      }
    },
    "viewSlots": {
      "setItemView": "GroupMembersViewHolderListeners — entire list item row",
      "setLeadingView": "GroupMembersViewHolderListeners — avatar / left section",
      "setTitleView": "GroupMembersViewHolderListeners — name / title text",
      "setSubtitleView": "GroupMembersViewHolderListeners — subtitle text below name",
      "setTrailingView": "GroupMembersViewHolderListeners — right section",
      "setLoadingStateView": "@LayoutRes int — loading spinner",
      "setEmptyStateView": "@LayoutRes int — empty state",
      "setErrorStateView": "@LayoutRes int — error state",
      "setOverflowMenu": "View — toolbar menu",
      "setOptions": "Function3<Context, GroupMember, Group, List<MenuItem>> — long-press context menu (replaces defaults)",
      "addOptions": "Function3<Context, GroupMember, Group, List<MenuItem>> — long-press context menu (appends to defaults)"
    },
    "advanced": {
      "selectGroupMember": "GroupMember, SelectionMode — programmatic selection",
      "clearSelection": "void — clears all selected group members",
      "getSelectedGroupMembers": "List<GroupMember> — returns selected items",
      "setSearchKeyword": "String — programmatic search",
      "setTitleText": "String — custom toolbar title",
      "excludeOwner": "boolean — exclude group owner from list",
      "getBinding": "CometchatGroupMembersListViewBinding — root ViewBinding",
      "getViewModel": "GroupMembersViewModel — internal ViewModel access",
      "getAdapter": "GroupMembersAdapter — internal adapter access",
      "setAdapter": "GroupMembersAdapter — replace the default adapter"
    },
    "style": {
      "setStyle": {
        "type": "@StyleRes int",
        "parent": "CometChatGroupMembersStyle"
      }
    }
  },
  "events": [
    {
      "name": "CometChatGroupEvents.ccGroupMemberBanned",
      "payload": "Action, User, User, Group",
      "description": "A group member was banned from the group"
    },
    {
      "name": "CometChatGroupEvents.ccGroupMemberKicked",
      "payload": "Action, User, User, Group",
      "description": "A group member was kicked from the group"
    },
    {
      "name": "CometChatGroupEvents.ccGroupMemberScopeChanged",
      "payload": "Action, User, String, String, Group",
      "description": "A group member's scope was changed"
    },
    {
      "name": "CometChatGroupEvents.ccGroupMemberAdded",
      "payload": "List<Action>, List<User>, Group, User",
      "description": "Members were added to the group"
    },
    {
      "name": "CometChatGroupEvents.ccGroupMemberUnBanned",
      "payload": "Action, User, User, Group",
      "description": "A group member was unbanned"
    },
    {
      "name": "CometChatGroupEvents.ccOwnershipChanged",
      "payload": "Group, GroupMember",
      "description": "Group ownership was transferred"
    }
  ],
  "sdkListeners": [
    "onGroupMemberJoined",
    "onGroupMemberLeft",
    "onGroupMemberKicked",
    "onGroupMemberBanned",
    "onGroupMemberScopeChanged",
    "onMemberAddedToGroup",
    "onUserOnline",
    "onUserOffline"
  ]
}

Where It Fits

CometChatGroupMembers is a list component. It renders all members of a specific group and emits the selected GroupMember via setOnItemClick. It requires a Group object set via setGroup() before it can load data. Wire it to CometChatMessageHeader, CometChatMessageList, and CometChatMessageComposer to build a group messaging layout.

Kotlin

GroupChatActivity.kt

class GroupChatActivity : AppCompatActivity() {

    private lateinit var groupMembers: CometChatGroupMembers
    private lateinit var messageHeader: CometChatMessageHeader
    private lateinit var messageList: CometChatMessageList
    private lateinit var messageComposer: CometChatMessageComposer

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_group_chat)

        groupMembers = findViewById(R.id.group_members)
        messageHeader = findViewById(R.id.message_header)
        messageList = findViewById(R.id.message_list)
        messageComposer = findViewById(R.id.message_composer)

        val group = Group().apply {
            guid = "GROUP_ID"
            name = "GROUP_NAME"
        }
        groupMembers.setGroup(group)

        groupMembers.setOnItemClick { view, position, groupMember ->
            messageHeader.setUser(groupMember)
            messageList.setUser(groupMember)
            messageComposer.setUser(groupMember)
        }
    }
}

Java

GroupChatActivity.java

public class GroupChatActivity extends AppCompatActivity {

    private CometChatGroupMembers groupMembers;
    private CometChatMessageHeader messageHeader;
    private CometChatMessageList messageList;
    private CometChatMessageComposer messageComposer;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_group_chat);

        groupMembers = findViewById(R.id.group_members);
        messageHeader = findViewById(R.id.message_header);
        messageList = findViewById(R.id.message_list);
        messageComposer = findViewById(R.id.message_composer);

        Group group = new Group();
        group.setGuid("GROUP_ID");
        group.setName("GROUP_NAME");
        groupMembers.setGroup(group);

        groupMembers.setOnItemClick((view, position, groupMember) -> {
            messageHeader.setUser(groupMember);
            messageList.setUser(groupMember);
            messageComposer.setUser(groupMember);
        });
    }
}

Quick Start

Add the component to your layout XML:

layout_activity.xml

<com.cometchat.chatuikit.groupmembers.CometChatGroupMembers
    android:id="@+id/group_member"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Prerequisites: CometChat SDK initialized with CometChatUIKit.init(), a user logged in, the cometchat-chat-uikit-android dependency added, and a valid Group object with a group ID (GUID).

Set the Group object in your Activity or Fragment:

Kotlin

YourActivity.kt

val cometchatGroupMembers: CometChatGroupMembers = binding.groupMember

val group = Group().apply {
    guid = "GROUP_ID"
    name = "GROUP_NAME"
}

cometchatGroupMembers.setGroup(group)

Java

YourActivity.java

CometChatGroupMembers cometchatGroupMembers = binding.groupMember;

Group group = new Group();
group.setGuid("GROUP_ID");
group.setName("GROUP_NAME");

cometchatGroupMembers.setGroup(group);

What this does: Creates a Group object with a group ID and name, then passes it to the CometChatGroupMembers component. The component fetches and displays all members of that group.

Or add programmatically in an Activity:

Kotlin

YourActivity.kt

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val groupMembers = CometChatGroupMembers(this)
    val group = Group().apply {
        guid = "GROUP_ID"
        name = "GROUP_NAME"
    }
    groupMembers.setGroup(group)
    setContentView(groupMembers)
}

Java

YourActivity.java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    CometChatGroupMembers groupMembers = new CometChatGroupMembers(this);
    Group group = new Group();
    group.setGuid("GROUP_ID");
    group.setName("GROUP_NAME");
    groupMembers.setGroup(group);
    setContentView(groupMembers);
}

Or in a Fragment:

Kotlin

YourFragment.kt

override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View {
    val groupMembers = CometChatGroupMembers(requireContext())
    val group = Group().apply {
        guid = "GROUP_ID"
        name = "GROUP_NAME"
    }
    groupMembers.setGroup(group)
    return groupMembers
}

Java

YourFragment.java

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    CometChatGroupMembers groupMembers = new CometChatGroupMembers(getContext());
    Group group = new Group();
    group.setGuid("GROUP_ID");
    group.setName("GROUP_NAME");
    groupMembers.setGroup(group);
    return groupMembers;
}

Filtering Group Members

Pass a GroupMembersRequest.GroupMembersRequestBuilder to setGroupMembersRequestBuilder. Pass the builder instance — not the result of .build().

Kotlin

val builder = GroupMembersRequest.GroupMembersRequestBuilder("GROUP_ID")
    .setLimit(10)
cometchatGroupMembers.setGroupMembersRequestBuilder(builder)

Java

GroupMembersRequest.GroupMembersRequestBuilder builder = new GroupMembersRequest.GroupMembersRequestBuilder("GROUP_ID")
    .setLimit(10);
cometchatGroupMembers.setGroupMembersRequestBuilder(builder);

Filter Recipes

Recipe	Code
Limit to 10 per page	builder.setLimit(10)
Search by keyword	builder.setSearchKeyword("john")
Filter by scopes	builder.setScopes(Arrays.asList("admin", "moderator"))
Admins only	builder.setScopes(Arrays.asList("admin"))
Moderators only	builder.setScopes(Arrays.asList("moderator"))
Participants only	builder.setScopes(Arrays.asList("participant"))

The component uses infinite scroll — the next page loads as the user scrolls to the bottom.

Search Request Builder

Use setSearchRequestBuilder to customize the search list separately from the main list:

Kotlin

val searchBuilder = GroupMembersRequest.GroupMembersRequestBuilder("GROUP_ID")
    .setLimit(LIMIT)
    .setSearchKeyword(SEARCH_KEYWORD)
cometchatGroupMembers.setSearchRequestBuilder(searchBuilder)

Java

GroupMembersRequest.GroupMembersRequestBuilder searchBuilder = new GroupMembersRequest.GroupMembersRequestBuilder("GROUP_ID")
    .setLimit(LIMIT)
    .setSearchKeyword(SEARCH_KEYWORD);
cometchatGroupMembers.setSearchRequestBuilder(searchBuilder);

What this does: Creates a GroupMembersRequestBuilder with a group ID, limit, and search keyword, then applies it as the search request builder. When the user searches, the component uses this builder to filter results.

Actions and Events

Callback Methods

setOnItemClick

Fires when a group member row is tapped. Primary navigation hook — set the active member and render the message view.

Kotlin

YourActivity.kt

cometchatGroupMembers.setOnItemClick { view, position, groupMember ->

}

Java

YourActivity.java

cometchatGroupMembers.setOnItemClick((view, position, groupMember) -> {

});

What this does: Replaces the default item-click behavior. When a user taps a group member, your custom lambda executes instead of the built-in navigation.

setOnItemLongClick

Fires when a group member row is long-pressed. Use for additional actions like kick, ban, or change scope.

Kotlin

YourActivity.kt

cometchatGroupMembers.setOnItemLongClick { view, position, groupMember ->

}

Java

YourActivity.java

cometchatGroupMembers.setOnItemLongClick((view, position, groupMember) -> {

});

setOnBackPressListener

Fires when the user presses the back button in the app bar. Default: navigates to the previous activity.

Kotlin

YourActivity.kt

cometchatGroupMembers.setOnBackPressListener {

}

Java

YourActivity.java

cometchatGroupMembers.setOnBackPressListener(() -> {

});

setOnSelection

Fires when a group member is checked/unchecked in multi-select mode. Requires setSelectionMode to be set.

Kotlin

YourActivity.kt

cometchatGroupMembers.setOnSelection(object : OnSelection<GroupMember?> {
    override fun onSelection(t: MutableList<GroupMember?>?) {

    }
})

Java

YourActivity.java

cometchatGroupMembers.setOnSelection(t -> {

});

setOnError

Fires on internal errors (network failure, auth issue, SDK exception).

Kotlin

YourActivity.kt

cometchatGroupMembers.setOnError {

}

Java

YourActivity.java

cometchatGroupMembers.setOnError(cometchatException -> {

});

setOnLoadMore

Fires when the list is successfully fetched and loaded.

Kotlin

YourActivity.kt

cometchatGroupMembers.setOnLoadMore(object : OnLoad<GroupMember?> {
    override fun onLoad(list: MutableList<GroupMember?>?) {

    }
})

Java

YourActivity.java

cometchatGroupMembers.setOnLoadMore(list -> {

});

setOnEmpty

Fires when the list is empty, enabling custom handling such as showing a placeholder.

Kotlin

YourActivity.kt

cometchatGroupMembers.setOnEmpty {

}

Java

YourActivity.java

cometchatGroupMembers.setOnEmpty(() -> {

});

• Verify: After setting an action callback, trigger the corresponding user interaction (tap, long-press, back, select) and confirm your custom logic executes instead of the default behavior.

Global UI Events

CometChatGroupEvents emits events subscribable from anywhere in the application. Add a listener and remove it when no longer needed.

Event	Fires when	Payload
ccGroupMemberBanned	A group member is banned from the group	Action, User, User, Group
ccGroupMemberKicked	A group member is kicked from the group	Action, User, User, Group
ccGroupMemberScopeChanged	A group member’s scope is changed	Action, User, String, String, Group
ccGroupMemberAdded	Members are added to the group	List<Action>, List<User>, Group, User
ccGroupMemberUnBanned	A group member is unbanned	Action, User, User, Group
ccOwnershipChanged	Group ownership is transferred	Group, GroupMember

Kotlin

Add Listener

CometChatGroupEvents.addGroupListener("LISTENER_TAG", object : CometChatGroupEvents() {
    override fun ccGroupMemberKicked(
        actionMessage: Action,
        kickedUser: User,
        kickedBy: User,
        kickedFrom: Group
    ) {
        super.ccGroupMemberKicked(actionMessage, kickedUser, kickedBy, kickedFrom)
    }

    override fun ccGroupMemberBanned(
        actionMessage: Action,
        bannedUser: User,
        bannedBy: User,
        bannedFrom: Group
    ) {
        super.ccGroupMemberBanned(actionMessage, bannedUser, bannedBy, bannedFrom)
    }

    override fun ccGroupMemberScopeChanged(
        actionMessage: Action,
        updatedUser: User,
        scopeChangedTo: String,
        scopeChangedFrom: String,
        group: Group
    ) {
        super.ccGroupMemberScopeChanged(
            actionMessage,
            updatedUser,
            scopeChangedTo,
            scopeChangedFrom,
            group
        )
    }
})

Remove Listener

CometChatGroupEvents.removeListener("LISTENER_TAG")

Java

Add Listener

CometChatGroupEvents.addGroupListener("LISTENER_TAG", new CometChatGroupEvents() {
    @Override
    public void ccGroupMemberKicked(Action actionMessage, User kickedUser, User kickedBy, Group kickedFrom) {
        super.ccGroupMemberKicked(actionMessage, kickedUser, kickedBy, kickedFrom);
    }

    @Override
    public void ccGroupMemberBanned(Action actionMessage, User bannedUser, User bannedBy, Group bannedFrom) {
        super.ccGroupMemberBanned(actionMessage, bannedUser, bannedBy, bannedFrom);
    }

    @Override
    public void ccGroupMemberScopeChanged(Action actionMessage, User updatedUser, String scopeChangedTo, String scopeChangedFrom, Group group) {
        super.ccGroupMemberScopeChanged(actionMessage, updatedUser, scopeChangedTo, scopeChangedFrom, group);
    }
});

Remove Listener

CometChatGroupEvents.removeListener("LISTENER_TAG");

What this does: Registers a global event listener tagged with "LISTENER_TAG". When a group member is kicked, banned, or has their scope changed, the corresponding callback fires with the action details, affected user, and group information.

SDK Events (Real-Time, Automatic)

The component listens to these SDK events internally. No manual attachment needed unless additional side effects are required.

SDK Listener	Internal behavior
onGroupMemberJoined	Adds the new member to the list
onGroupMemberLeft	Removes the member from the list
onGroupMemberKicked	Removes the kicked member from the list
onGroupMemberBanned	Removes the banned member from the list
onGroupMemberScopeChanged	Updates the member’s scope in the list
onMemberAddedToGroup	Adds the new member to the list
onUserOnline	Updates online status indicator for the member
onUserOffline	Updates offline status indicator for the member

Automatic: group membership changes and user presence changes update the list in real time.

Functionality

Small functional customizations such as toggling visibility of UI elements and configuring selection modes.

Methods	Description	Code
setGroup	Sets the group whose members need to be fetched. Required for the component to function.	.setGroup(group);
setBackIconVisibility	Toggles visibility for the back button in the app bar	.setBackIconVisibility(View.VISIBLE);
setToolbarVisibility	Toggles visibility for the toolbar in the app bar	.setToolbarVisibility(View.GONE);
setLoadingStateVisibility	Hides the loading state while fetching members	.setLoadingStateVisibility(View.GONE);
setErrorStateVisibility	Hides the error state on fetching members	.setErrorStateVisibility(View.GONE);
setEmptyStateVisibility	Hides the empty state on fetching members	.setEmptyStateVisibility(View.GONE);
setSeparatorVisibility	Controls visibility of separators in the list view	.setSeparatorVisibility(View.GONE);
setUserStatusVisibility	Controls visibility of the online status indicator	.setUserStatusVisibility(View.GONE);
setSearchBoxVisibility	Controls visibility of the search box in the toolbar	.setSearchBoxVisibility(View.GONE);
setSelectionMode	Determines the selection mode (single or multiple)	.setSelectionMode(UIKitConstants.SelectionMode.MULTIPLE);
setSearchKeyword	Programmatically triggers a search with the given keyword	.setSearchKeyword("anything");
setTitleText	Sets a custom title in the toolbar	.setTitleText("Members");
setKickMemberOptionVisibility	Toggles visibility for the kick member option in the long-press menu	.setKickMemberOptionVisibility(View.GONE);
setBanMemberOptionVisibility	Toggles visibility for the ban member option in the long-press menu	.setBanMemberOptionVisibility(View.GONE);
setScopeChangeOptionVisibility	Toggles visibility for the scope change option in the long-press menu	.setScopeChangeOptionVisibility(View.GONE);
excludeOwner	When true, excludes the group owner from the member list	.excludeOwner(true);

• Verify: After calling a visibility method, confirm the corresponding UI element is shown or hidden.

Custom View Slots

Each slot replaces a section of the default UI. Slots that accept a GroupMember parameter receive the group member object for that row via the GroupMembersViewHolderListeners pattern (createView + bindView).

Slot	Method	Replaces
Leading view	setLeadingView(GroupMembersViewHolderListeners)	Avatar / left section
Title view	setTitleView(GroupMembersViewHolderListeners)	Name / title text
Subtitle view	setSubtitleView(GroupMembersViewHolderListeners)	Subtitle text below name
Trailing view	setTrailingView(GroupMembersViewHolderListeners)	Right section
Item view	setItemView(GroupMembersViewHolderListeners)	Entire list item row
Loading view	setLoadingStateView(@LayoutRes int)	Loading spinner
Empty view	setEmptyStateView(@LayoutRes int)	Empty state
Error view	setErrorStateView(@LayoutRes int)	Error state
Overflow menu	setOverflowMenu(View)	Toolbar menu
Options (replace)	setOptions(Function3)	Long-press context menu (replaces defaults)
Options (append)	addOptions(Function3)	Long-press context menu (appends to defaults)

setLeadingView

Replace the avatar / left section.

Kotlin

cometchatGroupMembers.setLeadingView(object : GroupMembersViewHolderListeners() {
    override fun createView(
        context: Context?,
        listItem: CometchatGroupMemberListItemBinding?
    ): View? {
        return null
    }

    override fun bindView(
        context: Context,
        createdView: View,
        groupMember: GroupMember,
        group: Group,
        holder: RecyclerView.ViewHolder,
        groupMemberList: List<GroupMember>,
        position: Int
    ) {
    }
})

Java

cometchatGroupMembers.setLeadingView(new GroupMembersViewHolderListeners() {
    @Override
    public View createView(Context context, CometchatGroupMemberListItemBinding listItem) {
        return null;
    }

    @Override
    public void bindView(Context context, View createdView, GroupMember groupMember, Group group, RecyclerView.ViewHolder holder, List<GroupMember> groupMemberList, int position) {

    }
});

What this does: Registers a GroupMembersViewHolderListeners that provides a custom view for the leading (left) area of each group member item. createView inflates your layout, and bindView populates it with group member data.

Scope badge avatar example:

Create a custom layout file named custom_title_view.xml:

custom_title_view.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="@dimen/cometchat_45dp"
    android:layout_height="@dimen/cometchat_45dp"
    android:orientation="vertical">

    <com.cometchat.chatuikit.shared.views.avatar.CometChatAvatar
        android:id="@+id/avatar"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

    <View
        android:id="@+id/batch_view"
        android:layout_width="match_parent"
        android:layout_height="@dimen/cometchat_12dp"
        android:layout_alignParentBottom="true"
        android:background="@drawable/admin_batch"
        android:visibility="gone" />

</RelativeLayout>

What this does: Defines a custom leading view layout with a CometChatAvatar and a role badge view that can display different backgrounds based on the member’s scope (admin, moderator, participant).

Kotlin

YourActivity.kt

cometchatGroupMembers.setLeadingView(object : GroupMembersViewHolderListeners() {
    override fun createView(context: Context?, listItem: CometchatGroupMemberListItemBinding?): View {
        return LayoutInflater.from(context).inflate(R.layout.header_leading_view, null, false)
    }

    override fun bindView(
        context: Context,
        createdView: View,
        groupMember: GroupMember,
        group: Group,
        holder: RecyclerView.ViewHolder,
        groupMemberList: List<GroupMember>,
        position: Int
    ) {
        val avatar = createdView.findViewById<CometChatAvatar>(R.id.avatar)
        avatar.setAvatar(groupMember.name, groupMember.avatar)
        val role = createdView.findViewById<View>(R.id.batch_view)
        if (UIKitConstants.GroupMemberScope.ADMIN == groupMember.scope) {
            role.visibility = View.VISIBLE
            role.background = ResourcesCompat.getDrawable(resources, R.drawable.marketing_head, null)
        } else if (UIKitConstants.GroupMemberScope.MODERATOR == groupMember.scope) {
            role.visibility = View.VISIBLE
            role.background = ResourcesCompat.getDrawable(resources, R.drawable.sr_manager, null)
        } else if (UIKitConstants.GroupMemberScope.PARTICIPANTS == groupMember.scope) {
            role.visibility = View.VISIBLE
            role.background = ResourcesCompat.getDrawable(resources, R.drawable.content_manager, null)
        } else {
            role.background = ResourcesCompat.getDrawable(resources, R.drawable.team_member, null)
        }
        val layoutParams = LinearLayout.LayoutParams(
            Utils.convertDpToPx(context, 40),
            Utils.convertDpToPx(context, 40)
        )
        createdView.layoutParams = layoutParams
    }
})

Java

YourActivity.java

cometchatGroupMembers.setLeadingView(new GroupMembersViewHolderListeners() {
    @Override
    public View createView(Context context, CometchatGroupMemberListItemBinding listItem) {
        return LayoutInflater.from(context).inflate(R.layout.header_leading_view, null, false);
    }

    @Override
    public void bindView(Context context, View createdView, GroupMember groupMember, Group group, RecyclerView.ViewHolder holder, List<GroupMember> groupMemberList, int position) {
        CometChatAvatar avatar = createdView.findViewById(R.id.avatar);
        avatar.setAvatar(groupMember.getName(), groupMember.getAvatar());
        View role = createdView.findViewById(R.id.batch_view);
        if (UIKitConstants.GroupMemberScope.ADMIN.equals(groupMember.getScope())) {
            role.setVisibility(View.VISIBLE);
            role.setBackground(ResourcesCompat.getDrawable(getResources(), R.drawable.marketing_head, null));
        } else if (UIKitConstants.GroupMemberScope.MODERATOR.equals(groupMember.getScope())) {
            role.setVisibility(View.VISIBLE);
            role.setBackground(ResourcesCompat.getDrawable(getResources(), R.drawable.sr_manager, null));
        } else if (UIKitConstants.GroupMemberScope.PARTICIPANTS.equals(groupMember.getScope())) {
            role.setVisibility(View.VISIBLE);
            role.setBackground(ResourcesCompat.getDrawable(getResources(), R.drawable.content_manager, null));
        } else {
            role.setBackground(ResourcesCompat.getDrawable(getResources(), R.drawable.team_member, null));
        }
        LinearLayout.LayoutParams layoutParams = new LinearLayout.LayoutParams(Utils.convertDpToPx(context, 40),
                                                                               Utils.convertDpToPx(context, 40));
        createdView.setLayoutParams(layoutParams);
    }
});

What this does: Inflates a custom leading view layout and populates it with the group member’s avatar and a role-based badge. If the member is an admin, the badge shows the marketing_head drawable; if a moderator, sr_manager; if a participant, content_manager; otherwise, team_member. The view is sized to 40dp × 40dp.

setTitleView

Replace the name / title text.

Kotlin

cometchatGroupMembers.setTitleView(object : GroupMembersViewHolderListeners() {
    override fun createView(
        context: Context?,
        listItem: CometchatGroupMemberListItemBinding?
    ): View? {
        return null
    }

    override fun bindView(
        context: Context,
        createdView: View,
        groupMember: GroupMember,
        group: Group,
        holder: RecyclerView.ViewHolder,
        groupMemberList: List<GroupMember>,
        position: Int
    ) {
    }
})

Java

cometchatGroupMembers.setTitleView(new GroupMembersViewHolderListeners() {
    @Override
    public View createView(Context context, CometchatGroupMemberListItemBinding listItem) {
        return null;
    }

    @Override
    public void bindView(Context context, View createdView, GroupMember groupMember, Group group, RecyclerView.ViewHolder holder, List<GroupMember> groupMemberList, int position) {

    }
});

Inline role badge example:

Create a custom layout file named custom_title_view.xml:

custom_title_view.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/user_layout"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:gravity="center_vertical"
    android:orientation="horizontal">

    <TextView
        android:id="@+id/title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="teacher"
        android:textAppearance="?attr/cometchatTextAppearanceHeading4Medium"
        android:textColor="?attr/cometchatTextColorPrimary" />

    <View
        android:id="@+id/role"
        android:layout_width="50dp"
        android:layout_height="15dp"
        android:layout_marginStart="@dimen/cometchat_16dp"
        android:background="@drawable/team_member" />
</LinearLayout>

What this does: Defines a custom title view layout with a TextView for the member name and a View for the role badge, arranged horizontally.

Kotlin

YourActivity.kt

cometchatGroupMembers.setTitleView(object : GroupMembersViewHolderListeners() {
    override fun createView(context: Context?, listItem: CometchatGroupMemberListItemBinding?): View {
        return LayoutInflater.from(context).inflate(R.layout.custom_title_view, null, false)
    }

    override fun bindView(
        context: Context,
        createdView: View,
        groupMember: GroupMember,
        group: Group,
        holder: RecyclerView.ViewHolder,
        groupMemberList: List<GroupMember>,
        position: Int
    ) {
        val layout = createdView.findViewById<LinearLayout>(R.id.user_layout)
        val layoutParams = LinearLayout.LayoutParams(
            ViewGroup.LayoutParams.WRAP_CONTENT,
            ViewGroup.LayoutParams.WRAP_CONTENT
        )
        layout.layoutParams = layoutParams
        val name = createdView.findViewById<TextView>(R.id.title)
        name.text = groupMember.name
        val role = createdView.findViewById<View>(R.id.role)
        if (UIKitConstants.GroupMemberScope.ADMIN == groupMember.scope) {
            role.visibility = View.VISIBLE
            role.background = ResourcesCompat.getDrawable(resources, R.drawable.marketing_head, null)
        } else if (UIKitConstants.GroupMemberScope.MODERATOR == groupMember.scope) {
            role.visibility = View.VISIBLE
            role.background = ResourcesCompat.getDrawable(resources, R.drawable.sr_manager, null)
        } else if (UIKitConstants.GroupMemberScope.PARTICIPANTS == groupMember.scope) {
            role.visibility = View.VISIBLE
            role.background = ResourcesCompat.getDrawable(resources, R.drawable.content_manager, null)
        } else {
            role.background = ResourcesCompat.getDrawable(resources, R.drawable.team_member, null)
        }
    }
})

Java

YourActivity.java

cometchatGroupMembers.setTitleView(new GroupMembersViewHolderListeners() {
    @Override
    public View createView(Context context, CometchatGroupMemberListItemBinding listItem) {
        return LayoutInflater.from(context).inflate(R.layout.custom_title_view, null, false);
    }

    @Override
    public void bindView(Context context, View createdView, GroupMember groupMember, Group group, RecyclerView.ViewHolder holder, List<GroupMember> groupMemberList, int position) {
        LinearLayout layout = createdView.findViewById(R.id.user_layout);
        LinearLayout.LayoutParams layoutParams = new LinearLayout.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT,
                                                                               ViewGroup.LayoutParams.WRAP_CONTENT);
        layout.setLayoutParams(layoutParams);
        TextView name = createdView.findViewById(R.id.title);
        name.setText(groupMember.getName());
        View role = createdView.findViewById(R.id.role);
        if (UIKitConstants.GroupMemberScope.ADMIN.equals(groupMember.getScope())) {
            role.setVisibility(View.VISIBLE);
            role.setBackground(ResourcesCompat.getDrawable(getResources(), R.drawable.marketing_head, null));
        } else if (UIKitConstants.GroupMemberScope.MODERATOR.equals(groupMember.getScope())) {
            role.setVisibility(View.VISIBLE);
            role.setBackground(ResourcesCompat.getDrawable(getResources(), R.drawable.sr_manager, null));
        } else if (UIKitConstants.GroupMemberScope.PARTICIPANTS.equals(groupMember.getScope())) {
            role.setVisibility(View.VISIBLE);
            role.setBackground(ResourcesCompat.getDrawable(getResources(), R.drawable.content_manager, null));
        } else {
            role.setBackground(ResourcesCompat.getDrawable(getResources(), R.drawable.team_member, null));
        }
    }
});

What this does: Inflates a custom title view layout and populates it with the group member’s name and a role-based badge. The badge background changes based on the member’s scope: marketing_head for admin, sr_manager for moderator, content_manager for participant, and team_member for others.

setSubtitleView

Replace the subtitle text below the member’s name.

Kotlin

cometchatGroupMembers.setSubtitleView(object : GroupMembersViewHolderListeners() {
    override fun createView(
        context: Context?,
        listItem: CometchatGroupMemberListItemBinding?
    ): View? {
        return null
    }

    override fun bindView(
        context: Context,
        createdView: View,
        groupMember: GroupMember,
        group: Group,
        holder: RecyclerView.ViewHolder,
        groupMemberList: List<GroupMember>,
        position: Int
    ) {
    }
})

Java

cometchatGroupMembers.setSubtitleView(new GroupMembersViewHolderListeners() {
    @Override
    public View createView(Context context, CometchatGroupMemberListItemBinding listItem) {
        return null;
    }

    @Override
    public void bindView(Context context, View createdView, GroupMember groupMember, Group group, RecyclerView.ViewHolder holder, List<GroupMember> groupMemberList, int position) {

    }
});

Example with join date:

Kotlin

YourActivity.kt

cometchatGroupMembers.setSubtitleView(object : GroupMembersViewHolderListeners() {
    override fun createView(
        context: Context?,
        listItem: CometchatGroupMemberListItemBinding?
    ): View {
        return TextView(context)
    }

    override fun bindView(
        context: Context,
        createdView: View,
        groupMember: GroupMember,
        group: Group,
        holder: RecyclerView.ViewHolder,
        groupMemberList: List<GroupMember>,
        position: Int
    ) {
        (createdView as TextView).text =
            "Joined at: " + SimpleDateFormat("dd/MM/yyyy, HH:mm:ss").format(groupMember.joinedAt * 1000)
    }
})

Java

YourActivity.java

cometchatGroupMembers.setSubtitleView(new GroupMembersViewHolderListeners() {
    @Override
    public View createView(Context context, CometchatGroupMemberListItemBinding listItem) {
        return new TextView(context);
    }

    @Override
    public void bindView(Context context, View createdView, GroupMember groupMember, Group group, RecyclerView.ViewHolder holder, List<GroupMember> groupMemberList, int position) {
        ((TextView) createdView).setText("Joined at: " + new SimpleDateFormat("dd/MM/yyyy, HH:mm:ss").format(groupMember.getJoinedAt() * 1000));
    }
});

What this does: Creates a TextView as the subtitle view and populates it with the group member’s join date formatted as “dd/MM/yyyy, HH:mm:ss”. The joinedAt timestamp is multiplied by 1000 to convert from seconds to milliseconds.

setTrailingView

Replace the right section of each group member item.

Kotlin

cometchatGroupMembers.setTrailingView(object : GroupMembersViewHolderListeners() {
    override fun createView(
        context: Context?,
        listItem: CometchatGroupMemberListItemBinding?
    ): View? {
        return null
    }

    override fun bindView(
        context: Context,
        createdView: View,
        groupMember: GroupMember,
        group: Group,
        holder: RecyclerView.ViewHolder,
        groupMemberList: List<GroupMember>,
        position: Int
    ) {
    }
})

Java

cometchatGroupMembers.setTrailingView(new GroupMembersViewHolderListeners() {
    @Override
    public View createView(Context context, CometchatGroupMemberListItemBinding listItem) {
        return null;
    }

    @Override
    public void bindView(Context context, View createdView, GroupMember groupMember, Group group, RecyclerView.ViewHolder holder, List<GroupMember> groupMemberList, int position) {

    }
});

Scope badge example:

Create a custom layout file named custom_tail_view.xml:

custom_tail_view.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content">

    <com.google.android.material.card.MaterialCardView
        android:id="@+id/scope_card"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        app:cardBackgroundColor="?attr/cometchatPrimaryColor"
        app:cardCornerRadius="@dimen/cometchat_radius_max"
        app:cardElevation="@dimen/cometchat_0dp">

        <TextView
            android:id="@+id/tv_scope"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:layout_gravity="center"
            android:paddingStart="@dimen/cometchat_padding_3"
            android:paddingTop="@dimen/cometchat_padding_1"
            android:paddingEnd="@dimen/cometchat_padding_3"
            android:paddingBottom="@dimen/cometchat_padding_1"
            android:text="@string/cometchat_owner"
            android:textAppearance="?attr/cometchatTextAppearanceCaption1Regular"
            android:textColor="?attr/cometchatPrimaryColor" />

    </com.google.android.material.card.MaterialCardView>

</LinearLayout>

What this does: Defines a custom trailing view layout with a MaterialCardView containing a TextView that displays the member’s scope as a colored badge.

Kotlin

YourActivity.kt

cometchatGroupMembers.setTrailingView(object : GroupMembersViewHolderListeners() {
    override fun createView(
        context: Context?,
        listItem: CometchatGroupMemberListItemBinding?
    ): View {
        return View.inflate(context, R.layout.custom_tail_view, null)
    }

    override fun bindView(
        context: Context,
        createdView: View,
        groupMember: GroupMember,
        group: Group,
        holder: RecyclerView.ViewHolder,
        groupMemberList: List<GroupMember>,
        position: Int
    ) {
        val cardView = createdView.findViewById<MaterialCardView>(R.id.scope_card)
        val tvName = createdView.findViewById<TextView>(R.id.tv_scope)
        cardView.setCardBackgroundColor(CometChatTheme.getExtendedPrimaryColor100(context))
        tvName.text = groupMember.scope
        createdView.visibility =
            if (groupMember.scope == UIKitConstants.GroupMemberScope.PARTICIPANTS) View.VISIBLE else View.GONE
    }
})

Java

YourActivity.java

cometchatGroupMembers.setTrailingView(new GroupMembersViewHolderListeners() {
    @Override
    public View createView(Context context, CometchatGroupMemberListItemBinding listItem) {
        return View.inflate(context, R.layout.custom_tail_view, null);
    }

    @Override
    public void bindView(Context context, View createdView, GroupMember groupMember, Group group, RecyclerView.ViewHolder holder, List<GroupMember> groupMemberList, int position) {
        MaterialCardView cardView = createdView.findViewById(R.id.scope_card);
        TextView tvName = createdView.findViewById(R.id.tv_scope);
        cardView.setCardBackgroundColor(CometChatTheme.getExtendedPrimaryColor100(context));
        tvName.setText(groupMember.getScope());
        createdView.setVisibility(groupMember.getScope().equals(UIKitConstants.GroupMemberScope.PARTICIPANTS) ? View.VISIBLE : View.GONE);
    }
});

What this does: Inflates a custom trailing view that displays a scope badge for each group member. The badge background uses the extended primary color, the text shows the member’s scope, and the badge is only visible for participants (hidden for admins, moderators, and owners).

setItemView

Replace the entire list item row.

Kotlin

cometchatGroupMembers.setItemView(object : GroupMembersViewHolderListeners() {
    override fun createView(
        context: Context?,
        listItem: CometchatGroupMemberListItemBinding?
    ): View? {
        return null
    }

    override fun bindView(
        context: Context,
        createdView: View,
        groupMember: GroupMember,
        group: Group,
        holder: RecyclerView.ViewHolder,
        groupMemberList: List<GroupMember>,
        position: Int
    ) {
    }
})

Java

cometchatGroupMembers.setItemView(new GroupMembersViewHolderListeners() {
    @Override
    public View createView(Context context, CometchatGroupMemberListItemBinding listItem) {
        return null;
    }

    @Override
    public void bindView(Context context, View createdView, GroupMember groupMember, Group group, RecyclerView.ViewHolder holder, List<GroupMember> groupMemberList, int position) {

    }
});

Example with name and scope:

Create a custom layout file named item_list.xml:

item_list.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical">

    <TextView
        android:id="@+id/tvName"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:maxLines="1"
        android:textAppearance="?attr/cometchatTextAppearanceHeading4Bold"
        android:textColor="?attr/cometchatTextColorPrimary" />

    <TextView
        android:id="@+id/tvSubtitle"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="@dimen/cometchat_margin_1"
        android:textAppearance="?attr/cometchatTextAppearanceBodyRegular"
        android:textColor="?attr/cometchatTextColorSecondary" />
</LinearLayout>

What this does: Defines a custom list item layout with two TextView elements: one for the member name and one for the subtitle (scope), arranged vertically.

Kotlin

YourActivity.kt

cometchatGroupMembers.setItemView(object : GroupMembersViewHolderListeners() {
    override fun createView(
        context: Context?,
        listItem: CometchatGroupMemberListItemBinding?
    ): View {
        return View.inflate(context, R.layout.custom_group_list_item, null)
    }

    override fun bindView(
        context: Context,
        createdView: View,
        groupMember: GroupMember,
        group: Group,
        holder: RecyclerView.ViewHolder,
        groupMemberList: List<GroupMember>,
        position: Int
    ) {
        val tvName = createdView.findViewById<TextView>(R.id.tvName)
        val tvScope = createdView.findViewById<TextView>(R.id.tvSubtitle)
        tvName.text = groupMember.name
        tvScope.text = groupMember.scope
    }
})

Java

YourActivity.java

cometchatGroupMembers.setItemView(new GroupMembersViewHolderListeners() {
    @Override
    public View createView(Context context, CometchatGroupMemberListItemBinding listItem) {
        return View.inflate(context, R.layout.custom_group_list_item, null);
    }

    @Override
    public void bindView(Context context, View createdView, GroupMember groupMember, Group group, RecyclerView.ViewHolder holder, List<GroupMember> groupMemberList, int position) {
        TextView tvName = createdView.findViewById(R.id.tvName);
        TextView tvScope = createdView.findViewById(R.id.tvSubtitle);
        tvName.setText(groupMember.getName());
        tvScope.setText(groupMember.getScope());
    }
});

What this does: Inflates a custom list item layout and populates it with the group member’s name and scope. Each list item shows the member name in the primary text style and their scope (admin, moderator, participant) in the secondary text style.

setOptions

Replace the long-press context menu entirely.

Kotlin

cometchatGroupMembers.setOptions { context, groupMember, group -> emptyList<CometChatPopupMenu.MenuItem?>() }

Java

cometchatGroupMembers.setOptions((context, groupMember, group) -> Collections.emptyList());

addOptions

Append to the long-press context menu without removing defaults.

Kotlin

cometchatGroupMembers.addOptions { context, groupMember, group -> emptyList<CometChatPopupMenu.MenuItem?>() }

Java

cometchatGroupMembers.addOptions((context, groupMember, group) -> Collections.emptyList());

setLoadingStateView

Sets a custom loading view displayed when data is being fetched.

Kotlin

cometchatGroupMembers.setLoadingStateView(R.layout.your_loading_view)

Java

cometchatGroupMembers.setLoadingStateView(R.layout.your_loading_view);

setEmptyStateView

Configures a custom view displayed when there are no group members in the list.

Kotlin

cometchatGroupMembers.setEmptyStateView(R.layout.your_empty_view)

Java

cometchatGroupMembers.setEmptyStateView(R.layout.your_empty_view);

setErrorStateView

Defines a custom error state view that appears when an issue occurs while loading group members.

Kotlin

cometchatGroupMembers.setErrorStateView(R.layout.your_error_view)

Java

cometchatGroupMembers.setErrorStateView(R.layout.your_error_view);

setOverflowMenu

Replace the toolbar overflow menu.

Kotlin

val addMemberIv = ImageView(this)
addMemberIv.setImageDrawable(ResourcesCompat.getDrawable(resources, R.drawable.ic_add, null))
cometchatGroupMembers.setOverflowMenu(addMemberIv)

Java

ImageView addMemberIv = new ImageView(this);
addMemberIv.setImageDrawable(ResourcesCompat.getDrawable(getResources(), R.drawable.ic_add, null));
cometchatGroupMembers.setOverflowMenu(addMemberIv);

What this does: Creates an ImageView with an add icon and sets it as the overflow menu in the group members toolbar. This provides a quick action button for adding new members.

• Verify: After setting any custom view slot, confirm the custom view renders in the correct position within the group member list item, and the data binding populates correctly for each member.

Common Patterns

Hide all chrome — minimal list

Kotlin

cometchatGroupMembers.setUserStatusVisibility(View.GONE)
cometchatGroupMembers.setSeparatorVisibility(View.GONE)
cometchatGroupMembers.setToolbarVisibility(View.GONE)

Java

cometchatGroupMembers.setUserStatusVisibility(View.GONE);
cometchatGroupMembers.setSeparatorVisibility(View.GONE);
cometchatGroupMembers.setToolbarVisibility(View.GONE);

Admins-only list

Kotlin

val builder = GroupMembersRequest.GroupMembersRequestBuilder("GROUP_ID")
    .setScopes(listOf("admin"))
cometchatGroupMembers.setGroupMembersRequestBuilder(builder)

Java

GroupMembersRequest.GroupMembersRequestBuilder builder = new GroupMembersRequest.GroupMembersRequestBuilder("GROUP_ID")
    .setScopes(Arrays.asList("admin"));
cometchatGroupMembers.setGroupMembersRequestBuilder(builder);

Exclude group owner

Kotlin

cometchatGroupMembers.excludeOwner(true)

Java

cometchatGroupMembers.excludeOwner(true);

Hide kick/ban/scope options

Kotlin

cometchatGroupMembers.setKickMemberOptionVisibility(View.GONE)
cometchatGroupMembers.setBanMemberOptionVisibility(View.GONE)
cometchatGroupMembers.setScopeChangeOptionVisibility(View.GONE)

Java

cometchatGroupMembers.setKickMemberOptionVisibility(View.GONE);
cometchatGroupMembers.setBanMemberOptionVisibility(View.GONE);
cometchatGroupMembers.setScopeChangeOptionVisibility(View.GONE);

Advanced Methods

Programmatic Selection

selectGroupMember

Programmatically selects or deselects a group member. Works with both SINGLE and MULTIPLE selection modes.

Kotlin

// Select a member in single-select mode
cometchatGroupMembers.selectGroupMember(groupMember, UIKitConstants.SelectionMode.SINGLE)

// Select a member in multi-select mode
cometchatGroupMembers.selectGroupMember(groupMember, UIKitConstants.SelectionMode.MULTIPLE)

Java

// Select a member in single-select mode
cometchatGroupMembers.selectGroupMember(groupMember, UIKitConstants.SelectionMode.SINGLE);

// Select a member in multi-select mode
cometchatGroupMembers.selectGroupMember(groupMember, UIKitConstants.SelectionMode.MULTIPLE);

In SINGLE mode, selecting a new member replaces the previous selection. In MULTIPLE mode, calling this on an already-selected member deselects it (toggle behavior).

getSelectedGroupMembers

Returns the list of currently selected GroupMember objects.

Kotlin

val selected = cometchatGroupMembers.selectedGroupMembers

Java

List<GroupMember> selected = cometchatGroupMembers.getSelectedGroupMembers();

Selected Group Members List

When using multi-select mode, a horizontal list of selected group members can be shown above the main list.

Method	Type	Description
setSelectedGroupMembersListVisibility	int (View.VISIBLE / View.GONE)	Show or hide the selected members strip
setSelectedGroupMemberAvatarStyle	@StyleRes int	Avatar style for selected member chips
setSelectedGroupMemberItemTextColor	@ColorInt int	Text color for selected member names
setSelectedGroupMemberItemTextAppearance	@StyleRes int	Text appearance for selected member names
setSelectedGroupMemberItemRemoveIcon	Drawable	Icon for the remove button on each chip
setSelectedGroupMemberItemRemoveIconTint	@ColorInt int	Tint color for the remove icon

Search Input Customization

The built-in search box can be customized programmatically:

Method	Type	Description
setSearchInputTextColor	@ColorInt int	Text color of the search input
setSearchInputPlaceHolderTextColor	@ColorInt int	Placeholder text color
setSearchInputIcon	Drawable	Leading icon in the search box
setSearchInputIconTint	@ColorInt int	Tint for the leading icon
setSearchInputEndIcon	Drawable	Trailing icon in the search box
setSearchInputEndIconTint	@ColorInt int	Tint for the trailing icon
setSearchInputStrokeWidth	@Dimension int	Stroke width of the search box border
setSearchInputStrokeColor	@ColorInt int	Stroke color of the search box border
setSearchInputBackgroundColor	@ColorInt int	Background color of the search box
setSearchInputCornerRadius	@Dimension int	Corner radius of the search box
setSearchInputTextAppearance	@StyleRes int	Text appearance of the search input

Internal Access

These methods provide direct access to internal components for advanced use cases.

Method	Returns	Description
getBinding()	CometchatGroupMembersListViewBinding	The ViewBinding for the component’s root layout
getViewModel()	GroupMembersViewModel	The ViewModel managing group member data and state
getAdapter()	GroupMembersAdapter	The adapter powering the RecyclerView
setAdapter(GroupMembersAdapter)	void	Replaces the default adapter with a custom one
getRecyclerView()	RecyclerView	The RecyclerView displaying the member list

Use these only when the standard API is insufficient. Directly manipulating the adapter or ViewModel may conflict with the component’s internal state management.

Style

The component uses XML theme styles. Define a custom style with parent CometChatGroupMembersStyle in themes.xml, then apply with setStyle().

themes.xml

    <style name="CustomAvatarStyle" parent="CometChatAvatarStyle">
        <item name="cometchatAvatarStrokeRadius">8dp</item>
        <item name="cometchatAvatarBackgroundColor">#FBAA75</item>
    </style>

    <style name="CustomGroupMembersStyle" parent="CometChatGroupMembersStyle">
        <item name="cometchatGroupMembersAvatarStyle">@style/CustomAvatarStyle</item>
        <item name="cometchatGroupMembersSeparatorColor">#F76808</item>
        <item name="cometchatGroupMembersTitleTextColor">#F76808</item>
        <item name="cometchatGroupMembersBackIconTint">#F76808</item>
    </style>

Kotlin

cometchatGroupMembers.setStyle(R.style.CustomGroupMembersStyle)

Java

cometchatGroupMembers.setStyle(R.style.CustomGroupMembersStyle);

What this does: Applies the CustomGroupMembersStyle theme to the CometChatGroupMembers component, changing the avatar, separator, title text, and back icon appearance.

To know more such attributes, visit the attributes file.

Programmatic Style Properties

In addition to XML theme styles, the component exposes programmatic setters for fine-grained control:

Method	Type	Description
setBackgroundColor	@ColorInt int	Background color of the component
setBackIconTint	@ColorInt int	Tint color for the back icon
setBackIcon	Drawable	Custom back icon drawable
setTitleTextColor	@ColorInt int	Title text color in the toolbar
setTitleTextAppearance	@StyleRes int	Title text appearance in the toolbar
setItemTitleTextColor	@ColorInt int	Text color for member item titles
setItemTitleTextAppearance	@StyleRes int	Text appearance for member item titles
setSeparatorColor	@ColorInt int	Color of list item separators
setSeparatorHeight	@Dimension int	Height of list item separators
setCornerRadius	@Dimension int	Corner radius of the component
setEmptyStateTitleTextColor	@ColorInt int	Title text color for the empty state
setEmptyStateTitleTextAppearance	@StyleRes int	Title text appearance for the empty state
setEmptyStateSubtitleTextColor	@ColorInt int	Subtitle text color for the empty state
setEmptyStateSubtitleTextAppearance	@StyleRes int	Subtitle text appearance for the empty state
setErrorStateTitleTextColor	@ColorInt int	Title text color for the error state
setErrorStateTitleTextAppearance	@StyleRes int	Title text appearance for the error state
setErrorStateSubtitleTextColor	@ColorInt int	Subtitle text color for the error state
setErrorStateSubtitleTextAppearance	@StyleRes int	Subtitle text appearance for the error state
setAvatarStyle	@StyleRes int	Style for member avatars
setStatusIndicatorStyle	@StyleRes int	Style for online/offline status indicators

Checkbox Style Properties (Selection Mode)

When using SINGLE or MULTIPLE selection mode, checkboxes appear on each item:

Method	Type	Description
setCheckBoxStrokeWidth	@Dimension int	Stroke width of the checkbox border
setCheckBoxCornerRadius	@Dimension int	Corner radius of the checkbox
setCheckBoxStrokeColor	@ColorInt int	Stroke color of the checkbox border
setCheckBoxBackgroundColor	@ColorInt int	Background color of unchecked checkbox
setCheckBoxCheckedBackgroundColor	@ColorInt int	Background color of checked checkbox
setSelectIcon	Drawable	Icon shown when checkbox is checked
setSelectIconTint	@ColorInt int	Tint for the checkbox select icon
setDiscardSelectionIcon	Drawable	Icon for the discard selection button
setDiscardSelectionIconTint	@ColorInt int	Tint for the discard selection icon
setSubmitSelectionIcon	Drawable	Icon for the submit selection button
setSubmitSelectionIconTint	@ColorInt int	Tint for the submit selection icon

Customization Matrix

What to change	Where	Property/API	Example
Override behavior on member interaction	Activity/Fragment	setOn<Event> callbacks	setOnItemClick((v, pos, m) -> { ... })
Filter which members appear	Activity/Fragment	setGroupMembersRequestBuilder	setGroupMembersRequestBuilder(builder)
Customize search results	Activity/Fragment	setSearchRequestBuilder	setSearchRequestBuilder(builder)
Toggle visibility of UI elements	Activity/Fragment	set<Feature>Visibility(int)	setUserStatusVisibility(View.GONE)
Replace a section of the list item	Activity/Fragment	set<Slot>View	setLeadingView(listener)
Change colors, fonts, spacing	themes.xml	CometChatGroupMembersStyle	<item name="cometchatGroupMembersSeparatorColor">#F76808</item>
Avatar style (corner radius, background)	themes.xml	cometchatGroupMembersAvatarStyle	<item name="cometchatAvatarStrokeRadius">8dp</item>
Apply a custom style	Activity/Fragment	setStyle(int styleRes)	cometchatGroupMembers.setStyle(R.style.CustomGroupMembersStyle);
Set the group	Activity/Fragment	setGroup(Group)	.setGroup(group);
Back button visibility	Activity/Fragment	setBackIconVisibility(int)	.setBackIconVisibility(View.VISIBLE);
Toolbar visibility	Activity/Fragment	setToolbarVisibility(int)	.setToolbarVisibility(View.GONE);
Error state visibility	Activity/Fragment	setErrorStateVisibility(int)	.setErrorStateVisibility(View.GONE);
Empty state visibility	Activity/Fragment	setEmptyStateVisibility(int)	.setEmptyStateVisibility(View.GONE);
Loading state visibility	Activity/Fragment	setLoadingStateVisibility(int)	.setLoadingStateVisibility(View.GONE);
Separator visibility	Activity/Fragment	setSeparatorVisibility(int)	.setSeparatorVisibility(View.GONE);
User online status visibility	Activity/Fragment	setUserStatusVisibility(int)	.setUserStatusVisibility(View.GONE);
Selection mode (single/multiple)	Activity/Fragment	setSelectionMode(SelectionMode)	.setSelectionMode(UIKitConstants.SelectionMode.MULTIPLE);
Search keyword	Activity/Fragment	setSearchKeyword(String)	.setSearchKeyword("anything");
Search box visibility	Activity/Fragment	setSearchBoxVisibility(int)	.setSearchBoxVisibility(View.GONE);
Custom toolbar title	Activity/Fragment	setTitleText(String)	.setTitleText("Members");
Long-press options (replace)	Activity/Fragment	setOptions(Function3)	See setOptions code above
Long-press options (append)	Activity/Fragment	addOptions(Function3)	See addOptions code above
Loading view	Activity/Fragment	setLoadingStateView(int)	.setLoadingStateView(R.layout.your_loading_view);
Empty view	Activity/Fragment	setEmptyStateView(int)	.setEmptyStateView(R.layout.your_empty_view);
Error view	Activity/Fragment	setErrorStateView(int)	.setErrorStateView(R.layout.your_error_view);
Leading view (avatar area)	Activity/Fragment	setLeadingView(GroupMembersViewHolderListeners)	See setLeadingView code above
Title view	Activity/Fragment	setTitleView(GroupMembersViewHolderListeners)	See setTitleView code above
Subtitle view	Activity/Fragment	setSubtitleView(GroupMembersViewHolderListeners)	See setSubtitleView code above
Trailing view	Activity/Fragment	setTrailingView(GroupMembersViewHolderListeners)	See setTrailingView code above
Entire list item	Activity/Fragment	setItemView(GroupMembersViewHolderListeners)	See setItemView code above
Overflow menu	Activity/Fragment	setOverflowMenu(View)	cometchatGroupMembers.setOverflowMenu(view);
Kick member option visibility	Activity/Fragment	setKickMemberOptionVisibility(int)	.setKickMemberOptionVisibility(View.GONE);
Ban member option visibility	Activity/Fragment	setBanMemberOptionVisibility(int)	.setBanMemberOptionVisibility(View.GONE);
Scope change option visibility	Activity/Fragment	setScopeChangeOptionVisibility(int)	.setScopeChangeOptionVisibility(View.GONE);
Exclude group owner	Activity/Fragment	excludeOwner(boolean)	.excludeOwner(true);
Programmatic selection	Activity/Fragment	selectGroupMember(GroupMember, SelectionMode)	.selectGroupMember(member, SelectionMode.SINGLE);
Selected members strip	Activity/Fragment	setSelectedGroupMembersListVisibility(int)	.setSelectedGroupMembersListVisibility(View.VISIBLE);
Internal adapter access	Activity/Fragment	getAdapter() / setAdapter()	Advanced use only

Accessibility

The component renders a scrollable RecyclerView of interactive group member items. Each member row responds to tap and long-press gestures. Avatar images include the member name as content description.

For custom views provided via setLeadingView, setTitleView, setTrailingView, or setItemView, ensure you set android:contentDescription on visual-only elements so TalkBack can announce them. The default views handle this automatically.

Online/offline status dots are visual-only by default. If screen reader descriptions are needed, provide them via a custom view with appropriate contentDescription attributes. Scope badges (admin, moderator, participant) should also include content descriptions when using custom trailing views.

Next Steps

Groups

Browse and search available groups

Users

Browse and search available users

Conversations

Browse recent conversations

Message List

Display messages in a conversation