# Form Mention Input

Comment box where typing @ opens a list of people to mention.

- id: `form-mention-input`
- Page: https://agentic-ui-kit.com/components/form-mention-input
- Live preview: https://agentic-ui-kit.com/live/component/form-mention-input?piece=form-mention-input

## Install

```bash
agentic-ui add form-mention-input
npx shadcn@4.17.0 add @agentic-ui/form-mention-input
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** at-mention, hash-topic, multi-trigger, autocomplete-listbox, token-chips, token-range-tracking, serialized-value, keyboard-navigation, auto-grow, form-field, dark-mode
- **Intents:** communicate, create-edit
- **Suits domains:** project-management, crm, support, saas, social
- **Interaction:** text-entry, autocomplete, keyboard-navigation
- **Screen role:** communication
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** comment box where typing @ opens a list of people to mention, textarea with @ and # triggers for users and topics with autocomplete, mention input that stores a serialized value with user ids, note editor that highlights mentioned teammates as chips
- **Avoid when:** a rich-text editor with formatting is required, the field only collects a list of values (use form-tag-input), plain text with no references to other records
- **Preserve when adapting:** serialization-format, range-tracking, listbox-semantics
- **Replace when adapting:** triggers, items, placeholder
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives
