# Prompt Suggestions
> Clickable suggestion chips that start a chat.
Source: https://shellui.dev/docs/v0.4/components/advanced/prompt-suggestions
`PromptSuggestions` is **new in v0.4.0**. It shows a row of suggested prompts as chips, usually in an empty [Chat](https://shellui.dev/docs/v0.4/components/advanced/chat.md), and passes the one the user clicks to `OnSelect`.
## Installation
```bash
shellui add prompt-suggestions
```
## Usage
### Basic
```razor
Picked: @(picked ?? "nothing yet")
@code {
private readonly string[] suggestions = { "What is ShellUI?", "Show me a dialog example", "How do I add a theme?" };
private string? picked;
}
```
### In a chat
Put it in the chat's `Footer` above the input while the conversation is empty, and send the picked suggestion the same way as typed text. `Disabled` stops a second pick while a reply is on its way.
```razor
@foreach (var message in messages)
{
}
@if (thinking)
{
}
@code {
private readonly List<(string Role, string Text)> messages = new()
{
("assistant", "Hi! I'm a ShellUI chat demo. Pick a question or type your own."),
};
private readonly string[] suggestions = { "What is ShellUI?", "Show me a dialog example", "How do I add a theme?" };
private string? draft;
private bool thinking;
private async Task SendAsync(string text)
{
messages.Add(("user", text));
thinking = true;
StateHasChanged();
await Task.Delay(800);
messages.Add(("assistant", $"You asked:\n{text}"));
thinking = false;
}
}
```
## API Reference
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `Suggestions` | `IEnumerable` | empty | The prompts to show, one chip each |
| `OnSelect` | `EventCallback` | — | Called with the clicked suggestion |
| `Disabled` | `bool` | `false` | Disables every chip |
| `Class` | `string?` | `null` | Additional CSS classes for the wrapper |
Other attributes are passed to the wrapping `