> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Dropzone Component

## Article: Dropzone Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/form/dropzone-component.md

## Article Content:

# Dropzone

_Components/Form_

Interactive docs page: <https://wix-pages.com/design-system-documentation/#/component/dropzone>

## Overview

```jsx
() => (
  <Box align="center">
    <CustomModalLayout
      primaryButtonText="Done"
      secondaryButtonText="Cancel"
      onCloseButtonClick={() => {}}
      title="Upload media"
      showHeaderDivider
      width="600px"
    >
      <Dropzone onDrop={() => {}}>
        <Dropzone.Overlay>
          <Box
            direction="vertical"
            height="100%"
            boxSizing="border-box"
            border="dashed 1px"
            borderRadius="6px"
            borderColor="B20"
          >
            <AddItem theme="filled" size="large">
              Drop Your Images Here
            </AddItem>
          </Box>
        </Dropzone.Overlay>
        <Dropzone.Content>
          <Box
            direction="vertical"
            border="dashed 1px"
            boxSizing="border-box"
            borderRadius="6px"
            padding="42px"
            borderColor="B30"
          >
            <EmptyState
              title="Drag your images here"
              subtitle="Or upload images from your computer"
              image="generic_add_item_illustration.svg"
            >
              <FileUpload onChange={() => {}}>
                {({ openFileUploadDialog }) => (
                  <TextButton
                    onClick={openFileUploadDialog}
                    prefixIcon={<Icons.Upload />}
                  >
                    Upload Images
                  </TextButton>
                )}
              </FileUpload>
            </EmptyState>
          </Box>
        </Dropzone.Content>
      </Dropzone>
    </CustomModalLayout>
  </Box>
);
```

Dropzone lets users drag and drop files to upload them in a specified area.

### Do

- Use it to upload files using drag and drop to a specified region.
- Use it to upload single or multiple files.

### Don't

- Don't use it to upload files via the native file picker. Use `<FileUpload/>` instead.

### Feature examples

#### Structure

This component consists of 2 elements:

- Use `<Dropzone.Content/>` to define the initial dropzone area's content.
- Use `<Dropzone.Overlay/>` to define what's shown to the user when a file is dragged into the dropzone.

```jsx
<StorybookComponents.Placeholder>
  <Dropzone onDrop={() => {}}>
    <Dropzone.Overlay>
      <StorybookComponents.Background skin="blue">
        <StorybookComponents.Stack
          height="300px"
          alignItems="center"
          justifyContent="center"
          width="100%"
        >
          Release on this Overlay to upload
        </StorybookComponents.Stack>
      </StorybookComponents.Background>
    </Dropzone.Overlay>
    <Dropzone.Content>
      <StorybookComponents.Stack
        height="300px"
        alignItems="center"
        justifyContent="center"
      >
        Drag file to this Dropzone
      </StorybookComponents.Stack>
    </Dropzone.Content>
  </Dropzone>
</StorybookComponents.Placeholder>;
```

### Common use case examples

#### Add item

Use a dropzone to upload multiple items to a designated area.

Include a dropzone to let users drag and drop multiple files to upload. For example, adding photos to an album or importing data from a CSV file.

```jsx
<Card>
  <Card.Header
    title={
      <Stepper
        activeStep={1}
        steps={[
          { text: 'Prepare', type: 'completed' },
          { text: 'Upload' },
          { text: 'Match', type: 'disabled' },
          { text: 'Label', type: 'disabled' },
        ]}
      />
    }
  />
  <Card.Divider />
  <Card.Content>
    <Layout gap="24px">
      <Cell>
        <Dropzone onDrop={() => {}}>
          <Dropzone.Overlay>
            <Box
              direction="vertical"
              height="100%"
              boxSizing="border-box"
              border="dashed 1px"
              borderRadius="6px"
              borderColor="B20"
            >
              <AddItem theme="filled" size="large">
                Drop your images here
              </AddItem>
            </Box>
          </Dropzone.Overlay>
          <Dropzone.Content>
            <Box
              direction="vertical"
              border="dashed 1px"
              boxSizing="border-box"
              borderRadius="6px"
              padding="42px"
              borderColor="B20"
            >
              <EmptyState
                title="Drag your images here"
                subtitle="Or upload images from your computer"
                image="generic_add_item_illustration.svg"
              >
                <FileUpload onChange={() => {}}>
                  {({ openFileUploadDialog }) => (
                    <TextButton
                      onClick={openFileUploadDialog}
                      prefixIcon={<Icons.Upload />}
                    >
                      Upload Images
                    </TextButton>
                  )}
                </FileUpload>
              </EmptyState>
            </Box>
          </Dropzone.Content>
        </Dropzone>
      </Cell>
      <Cell>
        <Box width="100%" align="space-between">
          <Button
            size="small"
            priority="secondary"
            prefixIcon={<Icons.ChevronLeftSmall />}
          >
            Back
          </Button>
          <Button size="small">Next</Button>
        </Box>
      </Cell>
    </Layout>
  </Card.Content>
</Card>;
```

## Code

```jsx
import { Dropzone } from '@wix/design-system';
```

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `children` | `ReactNode` | — | Accepts `<Dropzone.Overlay />` or `<Dropzone.Content />`. Both of them can contain any required content. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `onDrop` *(required)* | `(files: File[]) => void` | — | Defines an event handler which is called when files are dropped over the dropzone. Dropped files are supplied as an argument to the function. |

## Testkit

Import the driver matching your test environment:

```jsx
// UniDriver
import { DropzoneUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { DropzoneTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { DropzoneTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { DropzoneTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### Driver methods

| Method | Description |
| --- | --- |
| `getContentElement` | Returns the content compound element inside the dropzone. |
| `getOverlayElement` | Returns the overlay compound element inside the dropzone. |
| `dropFiles` | fires a drop event with the given files. |
| `exists` | Checks whether the component found with the given data hook. |
| `element` | Gets the component root element. |
| `click` | Clicks on the component root element. |
| `base` | Returns UniDriver for the base element. |

## Changelog

- **1.340.0** (2026-10-21) — maintenance release, no component-specific changes
- **1.339.0** (2026-10-19) — maintenance release, no component-specific changes
- **1.338.0** (2026-10-15) — maintenance release, no component-specific changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.320.0** (2026-09-03) — maintenance release, no component-specific changes
- **1.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.292.0** (2026-06-22) — maintenance release, no component-specific changes
- **1.266.0** (2026-04-07) — maintenance release, no component-specific changes
- **1.260.0** (2026-03-17) — maintenance release, no component-specific changes
- **1.187.1** (2025-05-08) — maintenance release, no component-specific changes
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **1.115.0** (2024-07-17) — maintenance release, no component-specific changes
- **1.104.1** (2024-05-14) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes