Skip to main content

Options

A single chip is one tappable follow-up; SuggestionList groups a capped set of chips (design caps at 3, ~40 characters each) beneath an agent response.

List of Suggestions

SuggestionList renders one chip per entry in suggestions and exposes the set to assistive tech as one labelled group — “Suggested replies” by default. Selecting a chip fires onSelect with that suggestion’s text and index; clearing the list and inserting the text into the message input is the consumer’s job.

Disabled

isDisabled dims the chip and blocks press and hover, but keeps it focusable for keyboard users.

Behavior

The chip responds to hover, press, and keyboard focus, and a list of chips wraps to fit its container.

Visual States

Hover and press shift the surface fill and lift to match Card; keyboard focus adds a ring without changing the fill.

Wrapping

SuggestionList wraps chips onto new lines once a row runs out of width, rather than overflowing or shrinking the chips.

Usage Guidelines

When to Use

Use the Suggestion or Suggestion List when:
  • One follow-up prompt – A single tappable chip offers one quick follow-up action or prompt. Use the Suggestion.
  • Follow-ups beneath an agent response – A small set of prompts sits under an agent response as one labelled group. Use the Suggestion List.

When not to use

Avoid using the Suggestion or Suggestion List for:
  • Several separate chips – Placing individual Suggestion chips side by side skips the shared group label and selection handling. Use the Suggestion List instead.
  • More than three prompts or long prompts – The Suggestion List does not enforce content limits. Trim the set to three suggestions of about 40 characters each.

Keyboard Interaction

Users can navigate and select a Suggestion using standard keyboard controls.
Last modified on October 16, 2026