Skip to content
Agent UI
Pickers & navigationSuggestionChips

Suggestion Chips

Quick-start prompt chips for empty chat states.

SuggestionChips ships with a full API table, a copyable example, and accessibility notes.

tsx

Installation

Install the package once, then import SuggestionChips from its direct entry point or from the root.

bash
pnpm add @agent-ui/react
tsx
import { SuggestionChips } from "@agent-ui/react/suggestion-chips";

Tailwind CSS v4 users: add @source "../node_modules/@agent-ui/react/src" to the global stylesheet so the library utilities are generated.

Usage

The example below is the same code that renders the preview. Copy it, swap in your own handlers, and ship.

tsx
import { SuggestionChips } from "@agent-ui/react";
 
<SuggestionChips
chips={[{ label: "Summarize", value: "Summarize this page" }]}
onSelect={(chip) => send(chip.value)}
/>

API reference

Every prop SuggestionChips accepts, its type, default, and behaviour.

API reference for this component
NameTypeDefaultDescription
chipsSuggestionChip[]—Items with label and value.
onSelect(chip: SuggestionChip) => void—Called with the picked chip.
classNamestring—Inherits every native div attribute, including id, aria-*, data-*, onClick, and style.
Use it with the rest of the library

SuggestionChips composes with MessageList, ChatShell, useChat, and the provider compose blocks. Browse the full reference or see all components in the gallery.

6 lines · copy-ready