# StreamMessageSearchListView

A Widget To Search For Messages Across Channels

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

![](/data/docs/chat-sdk/flutter/v9-latest/_assets/message_search_list_view.png)

### Background

Users in Stream Chat can have several channels and it can get hard to remember which channel has the
message they are searching for. As such, there needs to be a way to search for a message across multiple
channels. This is where `StreamMessageSearchListView` comes in.

<admonition type="note">

Make sure to check the [StreamMessageSearchListController](/chat/docs/sdk/flutter/stream_chat_flutter_core/stream_message_search_list_controller/) documentation for more information on how to use the controller to manipulate the `StreamMessageSearchListView`.

</admonition>

### Basic Example

While the `StreamMessageListView` is tied to a certain `StreamChannel`, a `StreamMessageSearchListView` is not.

```dart
class StreamMessageSearchPage extends StatefulWidget {
  const StreamMessageSearchPage({
    super.key,
    required this.client,
  });

  final StreamChatClient client;

  @override
  State<StreamMessageSearchPage> createState() => _StreamMessageSearchState();
}

class _StreamMessageSearchState extends State<StreamMessageSearchPage> {
  late final _controller = StreamMessageSearchListController(
    client: widget.client,
    limit: 20,
    filter: Filter.in_(
      'members',
      [StreamChat.of(context).user!.id],
    ),
    searchQuery: 'your query here',
  );

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) => Scaffold(
        body: StreamMessageSearchListView(
          controller: _controller,
        ),
      );
}
```

### Customize The Result Tiles

You can use your own widget for the result items using the `itemBuilder` parameter.

```dart
StreamMessageSearchListView(
  // ...
  itemBuilder: (context, responses, index, defaultWidget) {
    return Text(responses[index].message.text);
  },
),
```


---

This page was last updated at 2026-03-13T13:13:39.152Z.

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