Forms

Checkbox

Checkbox input with v-model support. Wraps the Polaris <s-checkbox> web component.

Usage

<script setup>
const agreed = ref(false)
</script>

<template>
  <ShCheckbox v-model="agreed" label="I agree to the terms" />
</template>

Props

PropTypeDefaultDescription
modelValuebooleanBound value (use with v-model)
labelstringCheckbox label
indeterminatebooleanIndeterminate state
defaultIndeterminatebooleanDefault indeterminate (uncontrolled)
defaultCheckedbooleanDefault checked (uncontrolled)
accessibilityLabelstringAccessible label
errorstringError message
detailsstringHelp text below the checkbox
requiredbooleanMarks the field as required
disabledbooleanDisables the checkbox
idstringElement ID
namestringForm field name

Events

EventPayloadDescription
update:modelValuebooleanEmitted when checked state changes
changeEventNative change event
inputEventNative input event

Slots

SlotDescription
defaultAdditional content

Polaris Element

Renders as <s-checkbox>. See Polaris Checkbox docs.

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

KiriminAja not affiliated with Shopify.