# 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`](/chat/docs/sdk/react-native/v8/core-components/channel#AutoCompleteSuggestionList/) on `Channel`.

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

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

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

<Channel AutoCompleteSuggestionList={AutoCompleteSuggestionListComponent} />;
```

## Props

### AutoCompleteSuggestionHeader

Renders the autocomplete suggestion header.

| Type          | Default                                                                                                        |
| ------------- | -------------------------------------------------------------------------------------------------------------- |
| ComponentType | [`AutoCompleteSuggestionHeader`](/chat/docs/sdk/react-native/v8/ui-components/autocomplete-suggestion-header/) |

### AutoCompleteSuggestionItem

Renders an autocomplete suggestion item.

| Type          | Default                                                                                                    |
| ------------- | ---------------------------------------------------------------------------------------------------------- |
| ComponentType | [`AutoCompleteSuggestionItem`](/chat/docs/sdk/react-native/v8/ui-components/autocomplete-suggestion-item/) |


---

This page was last updated at 2026-04-17T17:33:44.734Z.

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