# Dropzone Upload

> A drag-and-drop multi-file upload modal built on the native `<dialog>` element — a dashed dropzone with a floating upload icon, CSV/XLSX/XLS validation and a 25MB limit, a live selected-file list, and Cancel/Import actions. Fully token-driven and design-system agnostic.

- Category: Dialog
- Frameworks: Vanilla, React + CSS, React + Tailwind
- Design system: Orchard
- Dark mode: yes
- Access: premium (Atheros AI Pass)
- Tags: modal, upload, dropzone
- Page: https://builder.atheros.ai/components/dropzone-upload
- Preview: https://d17nmjscumqk5d.cloudfront.net/builder/templates/tpl_builder_dropzone_upload/preview-832c852bc4c5.webp

## Features

- Native `<dialog>` element with built-in Escape-to-close and focus trapping
- Backdrop scrim click-to-close with focus return to the trigger button
- Drag-and-drop dropzone with a drag-over highlight and a floating upload icon
- Multi-file selection via click or drop, with a live selected-file list
- Client-side validation: CSV / XLSX / XLS types only, 25MB total size limit
- Inline validation feedback rendered into an `aria-live` region
- Cancel (reset) and Import (submit) actions plus a Help Center link
- Responsive layout that stacks the action row on narrow screens and respects reduced motion

## Accessibility

- **Dialog semantics** — `role="dialog"`, `aria-modal="true"`, `aria-labelledby` on the title
- **Dropzone region** — `role="region"` with `aria-label`, file list in an `aria-live="polite"` region
- **File input** — `aria-label` and `aria-describedby` linking the dropzone message
- **Buttons** — `<button>` with `aria-label` on trigger, close, Cancel, and Import
- **Focus management** — Escape and backdrop close return focus to the trigger
- **Focus indicators** — `:focus-visible` with `--ring` outline on all elements
- **Reduced motion** — `prefers-reduced-motion: reduce` disables all animations

## Keyboard shortcuts

- `Escape` — Close the dialog (native `<dialog>` behavior)

## Common questions

**Which frameworks is Dropzone Upload available in?**

Dropzone Upload ships as Vanilla, React + CSS and React + Tailwind — HTML, CSS, JS and React source you can copy, download or clone into Atheros AI Builder.

**Is the Dropzone Upload dialog component free?**

Dropzone Upload is a premium component. Anyone can preview it; the source, downloads and AI customisation are included with Atheros AI Pass.

**Does Dropzone Upload support dark mode?**

Yes. Dropzone Upload ships light and dark themes, both drawn from the Orchard design system's tokens. Switch the preview to dark mode to compare them.

## Get the code

Preview Dropzone Upload live, then sign in to copy or download the source, apply another design system, or ask the AI assistant to change it: https://builder.atheros.ai/components/dropzone-upload

Every component on https://builder.atheros.ai is also reachable from Claude Code, Cursor and Codex through the Atheros MCP server (paid plans). Component index: https://builder.atheros.ai/llms-components.txt