# AI Attachments Bar

File and image attachment chips above the chat composer with remove buttons.

- id: `ai-attachments-bar`
- Page: https://agentic-ui-kit.com/components/ai-attachments-bar
- Live preview: https://agentic-ui-kit.com/live/component/ai-attachments-bar?piece=ai-attachments-bar

## Install

```bash
agentic-ui add ai-attachments-bar
npx shadcn@4.17.0 add @agentic-ui/ai-attachments-bar
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** attachment-chips, file-image-url-attachments, preview-dialog, remove-attachment, delete-key-remove, upload-progress, upload-error-retry, status-summary, controlled-or-uncontrolled, dark-mode
- **Intents:** converse, import-export
- **Suits domains:** ai-workspace, ai-agents, file-storage, support, saas
- **Interaction:** click, remove, retry, preview, keyboard-focus
- **Screen role:** communication
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** file and image attachment chips above the chat composer with remove buttons, attachments bar with upload progress, error state and retry, show attached files, links and screenshots before sending a prompt, with a preview on click, uploaded file chips with size and a progress line
- **Avoid when:** the drop zone or file picker itself (use form-file-upload), a gallery of generated images (use ai-generated-gallery), a file manager with folders and permissions
- **Preserve when adapting:** status-text-not-colour, preview-focus-return, progress-semantics
- **Replace when adapting:** items, upload-handler, preview-source
- **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