ChatSuggestions API

API reference docs for the React ChatSuggestions component. Learn about the props, CSS, and other APIs of this exported module.

Demos

For examples and details on the usage of this React component, visit the component demo pages:

import { ChatSuggestions } from '@mui/x-chat/ChatSuggestions';
// or
import { ChatSuggestions } from '@mui/x-chat';

Props of the native component are also available.

Name	Type	Default	Description
alwaysVisible	bool	false	By default, suggestions only render when the active thread has no messages (treating them as an empty-state affordance). Set to `true` to render the suggestions regardless of message count — e.g. as a "next prompt" row above the composer in an active conversation.
autoSubmit	bool	false	Whether to auto-submit when a suggestion is clicked.
children	node	-	The suggestions to render, instead of `suggestions`.
classes	object	-	Override or extend the styles applied to the component. See CSS classes API below for more details.
slotProps	object	{}	The props used for each component slot.
slots	object	{}	Overridable component slots. See Slots API below for more details.
suggestions	Array<{ label?: string, value: string } \| string>	-	Suggestion items. Strings are normalized to `{ value, label }`. Ignored when `children` are provided.
sx	Array<func \| object \| bool> \| func \| object	-	The system prop that allows defining system overrides as well as additional CSS styles. See the `sx` page for more details.

The component cannot hold a ref.

Slot name	Class name	Default component	Description
root	.MuiChatSuggestions-root		The component that renders the root.
item	.MuiChatSuggestions-item		The component that renders each suggestion.

If you did not find the information in this page, consider having a look at the implementation of the component for more detail.