# Thinking Indicator (/docs/agent-ui/components/thinking-indicator)

Use a thinking indicator between sending a message and the first word of the reply. Its label shimmers, and three small dots flow after it.

<Example caption="The label shimmers and the dots flow while the agent thinks. With reduced motion on, both hold still.">
<g />

```tsx
import { ThinkingIndicator } from "@/components/ui/thinking-indicator";

export default function ThinkingIndicatorExample() {
  return <ThinkingIndicator />;
}
```
</Example>

## Installation [#installation]

```bash tab="React"
npx shadcn@latest add @kind-ui/thinking-indicator
```

```bash tab="Web Components"
npx shadcn@latest add @kind-ui/thinking-indicator-web
```

## Usage [#usage]

### Label [#label]

Pass `label` to say what the agent is doing, like "Searching the docs". It shows before the dots and names the indicator, "Thinking" by default. The indicator is a polite status, so screen readers read a new label when it changes. The dots are hidden from them.

### Motion [#motion]

The label shimmers and the dots flow one after another. Under `prefers-reduced-motion`, or with `motion="reduced"` or `"none"`, both hold still. The indicator takes no focus and has no keys.

## API Reference [#api-reference]

### IndicatorOptions

| Prop      | Type                            | Description                                                                                                                                                       |
| --------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `label?`  | `string \| undefined`           | Names the status, and screen readers read it again when it changes. Loader and Thinking Indicator also show it; it defaults to "Loading", "Thinking" or "Typing". |
| `motion?` | `"auto" \| "none" \| "reduced"` | Whether the dots move: `"auto"` follows `prefers-reduced-motion`, and `"reduced"` or `"none"` hold them still. Default: `"auto"`                                  |

### Agent [#agent]

An agent connected with `createAgent` sees the thinking indicator as a status named by its label. It has no actions of its own.

<Caption>
Runs in React and Web Components. On `<kind-thinking-indicator>`, `label` and `motion` are attributes of the same name, and the element fills in its label and dots when it has no children.
</Caption>