Forms

DropZone

File drop zone with v-model support. Wraps the Polaris <s-drop-zone> web component.

Usage

<script setup>
const file = ref('')
</script>

<template>
  <ShDropZone v-model="file" label="Upload image" accept="image/*" />
</template>

Props

PropTypeDefaultDescription
modelValuestringBound value (use with v-model)
labelstringDrop zone label
acceptstringAccepted file types
multiplebooleanAllow multiple files
errorstringError message
accessibilityLabelstringAccessible label
labelAccessibilityVisibility'visible' | 'exclusive'Label visibility for assistive tech
requiredbooleanMarks the field as required
disabledbooleanDisables the drop zone
namestringForm field name

Events

EventPayloadDescription
update:modelValuestringEmitted when value changes (v-model)
changeEventNative change event
inputEventNative input event
droprejectedEventEmitted when a dropped file is rejected

Slots

SlotDescription
defaultCustom drop zone content

Polaris Element

Renders as <s-drop-zone>. See Polaris DropZone docs.

© 2026 KiriminAja. Polaris and Shopify are trademarks of Shopify Inc.

KiriminAja not affiliated with Shopify.