# StreamChannelListEventHandler

A Class To Customize The Event Handler For The StreamChannelListController.

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

### Background

A `StreamChannelListEventHandler` is a class that handles the events that are related to the channel list loaded by `StreamChannelListController`.
The `StreamChannelListController` automatically creates a `StreamChannelListEventHandler` internally and handles the events. In order to provide a custom
implementation of `StreamChannelListEventHandler`, you need to create a class that extends the `StreamChannelListEventHandler` class.

### Basic Example

There are 2 ways to provide a custom implementation of `StreamChannelListEventHandler`:

- Create a class that extends the `StreamChannelListEventHandler` and pass it down to the controller.

```dart
class MyCustomEventHandler extends StreamChannelListEventHandler {
  @override
  void onConnectionRecovered(
    Event event,
    StreamChannelListController controller,
  ) {
    // Write your own custom implementation here
  }
}
```

Pass it down to the controller:

```dart
  late final listController = StreamChannelListController(
    client: StreamChat.of(context).client,
    eventHandler: MyCustomEventHandler(),
  );
```

- Mix the `StreamChannelListEventHandler` into your widget state.

```dart
class _ChannelListPageState extends State<ChannelListPage> {

  late final _listController = StreamChannelListController(
    client: StreamChat.of(context).client,
    eventHandler: MyCustomEventHandler(),
  );
}
```


---

This page was last updated at 2026-05-22T16:31:59.990Z.

For the most recent version of this documentation, visit [https://getstream.io/chat/docs/sdk/flutter/v5/stream-chat-flutter-core/stream-channel-list-event-handler/](https://getstream.io/chat/docs/sdk/flutter/v5/stream-chat-flutter-core/stream-channel-list-event-handler/).