Switch

A control that indicates whether a setting is on or off.

Overview

Use Switch for an on/off setting that takes effect immediately or changes a persistent preference.

Switches are useful for feature settings, notifications, privacy choices, and simple enabled or disabled states. Use Checkbox when the option is part of a form submission or a list of independent choices.

Anatomy

A switch has a track, thumb, label, optional description, and checked state.

Behavior

Use clear labels that describe the enabled state. Avoid labels like On or Enable without context.

Accessibility

Connect the switch to a label. If changing the switch has a delayed effect, show feedback so users know the update worked.

Installation

npm
npx love-ui@latest add switch

Usage

import { Switch } from "@/components/ui/switch"
<Switch />

Examples

The examples show disabled, described, card-style, and form-connected switches.

For accessible labelling and validation, prefer using the Field component to wrap checkboxes. See the related example: Switch field.

Disabled

With Description

By enabling marketing emails, you agree to receive emails.

Card Style

Form Integration

On this page