# AutoCompleteSuggestionList

Renders the autocomplete list.

## Best Practices

- Keep the list height reasonable so it doesn't obscure the input.
- Use a consistent header/item design for clarity across triggers.
- Avoid heavy re-renders by memoizing list components.
- Use SDK-provided components as a base to preserve behavior.
- Ensure accessibility for keyboard and screen-reader users.

## General Usage

Customize `AutoCompleteSuggestionList` and pass it via [`AutoCompleteSuggestionList`](https://getstream.io/chat/docs/sdk/react-native/core-components/channel#component-overrides) on `Channel`.

See [`Customizing autocomplete suggestions`](https://getstream.io/chat/docs/sdk/react-native/guides/customize-autocomplete-suggestion-list/) for details.

```tsx
import {
  Channel,
  AutoCompleteSuggestionList,
  WithComponents,
} from "stream-chat-react-native";

const AutoCompleteSuggestionListComponent = () => (
  <AutoCompleteSuggestionList />
);

<WithComponents
  overrides={{
    AutoCompleteSuggestionList: AutoCompleteSuggestionListComponent,
  }}
>
  <Channel channel={channel} />
</WithComponents>;
```

## Props

| Prop                           | Description                                 | Type            | Default                                                                                                     |
| ------------------------------ | ------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------- |
| `AutoCompleteSuggestionHeader` | Renders the autocomplete suggestion header. | `ComponentType` | [`AutoCompleteSuggestionHeader`](https://getstream.io/chat/docs/sdk/react-native/ui-components/autocomplete-suggestion-header/) |
| `AutoCompleteSuggestionItem`   | Renders an autocomplete suggestion item.    | `ComponentType` | [`AutoCompleteSuggestionItem`](https://getstream.io/chat/docs/sdk/react-native/ui-components/autocomplete-suggestion-item/)     |


---

This page was last updated at 2026-08-13T00:26:19.330Z.

For the most recent version of this documentation, visit [https://getstream.io/chat/docs/sdk/react-native/ui-components/autocomplete-suggestion-list/](https://getstream.io/chat/docs/sdk/react-native/ui-components/autocomplete-suggestion-list/).