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
modelValueboolean—Bound value (use with v-model)
labelstring—Checkbox label
indeterminateboolean—Indeterminate state
defaultIndeterminateboolean—Default indeterminate (uncontrolled)
defaultCheckedboolean—Default checked (uncontrolled)
accessibilityLabelstring—Accessible label
errorstring—Error message
detailsstring—Help text below the checkbox
requiredboolean—Marks the field as required
disabledboolean—Disables the checkbox
idstring—Element ID
namestring—Form 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.