> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argide.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# User Suggestions

> Show quick-action chips in the chat widget

User suggestions are clickable chips that appear in the chat widget before the user types anything. They give users one-tap access to common questions and actions — no typing required.

## Setup

<Steps>
  <Step title="Open the dashboard">
    Go to [Agent → Suggestions](https://dashboard.argide.ai/agent/suggestions).
  </Step>

  <Step title="Add suggestions">
    Click **Add Suggestion** and fill in:

    | Field            | Description                                                              |
    | ---------------- | ------------------------------------------------------------------------ |
    | **Button label** | Text shown on the chip (e.g., "Track my order")                          |
    | **Message**      | Text sent to the agent when clicked. Defaults to the label if left empty |
  </Step>

  <Step title="Save and preview">
    Click **Save Changes**. The live preview on the right shows exactly how the chips will appear in your widget.
  </Step>
</Steps>

***

## How It Works

1. You configure suggestion chips in the dashboard
2. The widget loads and displays them as clickable buttons above the input
3. When a user clicks a chip, the **message** is sent to the agent as if the user typed it
4. If the message field is empty, the **label** text is sent instead

***

## Best Practices

<CardGroup cols={2}>
  <Card title="Keep labels short" icon="text-size">
    2–4 words work best so chips don't wrap on mobile (e.g., "Track order" instead of "I want to track my order status")
  </Card>

  <Card title="Use specific messages" icon="message">
    The label is what users see; the message is what the agent receives. Use the message field for detailed prompts the agent can act on
  </Card>

  <Card title="Cover common questions" icon="circle-question">
    Look at your most frequent conversations in [Activity](/monitor/activity) and turn them into suggestions
  </Card>

  <Card title="Limit to 3–4 chips" icon="grip">
    Too many options cause decision fatigue. Focus on the most valuable actions
  </Card>
</CardGroup>

***

## Examples

Here are some suggestions for different use cases:

| Use Case   | Label                 | Message                                        |
| ---------- | --------------------- | ---------------------------------------------- |
| E-commerce | Track my order        | What is the status of my most recent order?    |
| E-commerce | Return an item        | I want to start a return                       |
| SaaS       | How do I get started? | Walk me through the initial setup              |
| SaaS       | Upgrade plan          | What plans are available and how do I upgrade? |
| Support    | Talk to a human       | I'd like to speak with a support agent         |
| Support    | Billing issue         | I have a question about my bill                |

<CardGroup cols={2}>
  <Card title="Actions" icon="bolt" href="/agent/actions">
    Enable agent capabilities
  </Card>

  <Card title="Embed Widget" icon="code" href="/setup/embed-widget">
    Full widget setup guide
  </Card>
</CardGroup>