# StreamMessageSearchGridView

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/StreamMessageSearchGridView-class.html)

### Background

The `StreamMessageSearchGridView` widget allows displaying a list of searched messages in a `GridView`.

<admonition type="note">

Make sure to check the [StreamMessageSearchListView](/chat/docs/sdk/flutter/stream-chat-flutter/message-list/stream-message-search-list-view/) documentation to know how to show results in a `ListView`.

</admonition>

### Basic Example

```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: StreamMessageSearchGridView(
          controller: _controller,
          itemBuilder: (context, values, index) {
           // return your custom widget here
          },
        ),
      );
}
```


---

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

For the most recent version of this documentation, visit [https://getstream.io/chat/docs/sdk/flutter/stream-chat-flutter/message-list/stream-message-search-grid-view/](https://getstream.io/chat/docs/sdk/flutter/stream-chat-flutter/message-list/stream-message-search-grid-view/).