Skip to main content
User suggestions are clickable buttons that appear above the chat input, giving users one-tap access to common actions.

Two Types

Page-Level Suggestions

Use window.crow('setSuggestedActions', [...]) to set persistent buttons for the current page. These reappear after every agent response.
Each suggestion has:
  • label — Button text shown to the user
  • message — Text sent to the agent when clicked

Per-Page Example (Next.js)

Agent-Driven Suggestions

The agent can show buttons on demand by calling the suggest_actions tool. Add instructions to your agent’s system prompt telling it when to offer buttons:
The agent calls suggest_actions with an array of { label, message } objects. These buttons clear automatically when the user sends their next message.

Dashboard Config

You can also set initial suggestions (shown before the user types anything) from the dashboard under Agent > Suggestions. These are stored in your product config and appear on widget load.