# UserListView

A Widget For Displaying And Selecting Users

Find the pub.dev documentation [here](https://pub.dev/documentation/stream_chat_flutter/latest/stream_chat_flutter/UserListView-class.html)

![](@chat-sdk/flutter/v9-latest/_assets/user_list_view.png)

### Background

A list of users is required for many different purposes: showing a list of users in a Channel,
selecting users to add in a channel, etc. The `UserListView` displays and allows selection of a list
of users along with multiple display configurations like a list and grid.

### Basic Example

Let's take a look at an example where we use the widget to autocomplete user names:

```dart
class UsersListPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: UsersBloc(
        child: UsersListView(
          filter: Filter.notEqual('id', StreamChat.of(context).user!.id),
          sort: [
            SortOption(
              'name',
              direction: 1,
            ),
          ],
          pagination: PaginationParams(
            limit: 25,
          ),
        ),
      ),
    );
  }
}
```

### Customize The User Items

You can use your own widget for the user items using the `userItemBuilder` parameter.

```dart
UsersListView(
  // ...
  userItemBuilder: (context, user, isSelected) {
    return Text(user.name);
  },
),
```

### Group Alphabetically

You can group alphabetically using the `groupAlphabetically` parameter:

```dart
UsersListView(
    //...
    groupAlphabetically: true,
),
```

### Selecting Users

The `UserListView` widget allows selecting users in a list by supplying a selected users list and callbacks
for when user items are tapped.

```dart
Set<User>? selectedUsers = {};

UsersListView(
    //...
    selectedUsers: selectedUsers,
    onUserTap: (user, _) {
        setState(() {
            selectedUsers.add(user);
        });
    },
),
```


---

This page was last updated at 2026-05-13T13:38:39.785Z.

For the most recent version of this documentation, visit [https://getstream.io/chat/docs/sdk/flutter/v3/stream_chat_flutter/user_list_view/](https://getstream.io/chat/docs/sdk/flutter/v3/stream_chat_flutter/user_list_view/).