> 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: CheckToggle Component

## Article: CheckToggle Component

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

## Article Content:

# CheckToggle

_Components/Form/CheckToggle_

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

## Overview

```jsx
<TableListItem
  options={[
    {
      value: <CheckToggle tooltipContent="Mark as completed" />,
      width: '30px',
    },
    { value: <Text>Send initial design draft to Mark</Text> },
  ]}
/>;
```

Check toggle allows users to make a binary choice between two states. It\`s commonly used to mark a specific item as completed or not.

### Do

- Use it to mark item as completed or not

### Don't

- Don't use it to turn the setting on or off. Use `<ToggleSwitch/>` instead.
- Don't use it to select a single or multiple items. Use `<Checkbox/>` or `<Radio/>` instead.

### Feature examples

#### Size

Adjust the component size using the \`size\` prop. The prop supports two sizes:\
 - \`medium\` - use where the component needs more emphasis\
 - \`small\` (default) - use in dense and compact layouts

```jsx
<StorybookComponents.Stack>
  <CheckToggle size="medium" checked />
  <CheckToggle size="small" checked />
</StorybookComponents.Stack>;
```

#### Skin

Style the component using the \`skin\` prop. This prop supports two skins:\
 - \`standard\` (default) - use in all common cases\
 - \`success\` - use to emphasize success states, such as _approved_

```jsx
<StorybookComponents.Stack>
  <CheckToggle skin="standard" checked />
  <CheckToggle skin="success" checked />
</StorybookComponents.Stack>;
```

#### State

Control the state of a component with:\
 - \`checked\` - use this state to mark an item as complete.\
 - \`disabled\` - disables all component interactions. Use it to highlight unavailable functions.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <StorybookComponents.Stack>
    <FormField label="Default" labelPlacement="right">
      <CheckToggle default />
    </FormField>
  </StorybookComponents.Stack>
  <StorybookComponents.Stack>
    <FormField label="Checked" labelPlacement="right">
      <CheckToggle checked />
    </FormField>
  </StorybookComponents.Stack>
  <StorybookComponents.Stack>
    <FormField label="Disabled" labelPlacement="right">
      <CheckToggle disabled />
    </FormField>
  </StorybookComponents.Stack>
  <StorybookComponents.Stack>
    <FormField label="Checked and disabled" labelPlacement="right">
      <CheckToggle disabled checked />
    </FormField>
  </StorybookComponents.Stack>
</StorybookComponents.Stack>;
```

#### Tooltip

Explain an action that's about to be performed with a descriptive message in a tooltip. Use the \`tooltipContent\` prop to pass the text to a tooltip.

```jsx
<StorybookComponents.Stack>
  <FormField
    label="Hover the check toggle to see a tooltip"
    labelPlacement="right"
  >
    <CheckToggle tooltipContent="Message explaining the action that will be performed" />
  </FormField>
</StorybookComponents.Stack>;
```

### Common use case examples

#### To-do list

Use the check toggle to mark items as completed, e.g., in lists of to-do tasks.

```jsx
() => {
  const renderItem = ({ text, checked: initiallyChecked }) => {
    const [checked, setChecked] = React.useState(initiallyChecked);
    const options = [
      {
        value: (
          <CheckToggle
            checked={checked}
            onChange={() => setChecked(!checked)}
          />
        ),
        width: 'auto',
      },
      {
        value: (
          <Text light={checked} secondary={checked}>
            {checked ? <s>{text}</s> : text}
          </Text>
        ),
      },
      {
        value: (
          <PopoverMenu
            triggerElement={
              <IconButton size="small" priority="secondary">
                <Icons.MoreSmall />
              </IconButton>
            }
          >
            <PopoverMenu.MenuItem text="Edit" prefixIcon={<Icons.Edit />} />
            <PopoverMenu.MenuItem
              skin="destructive"
              text="Delete"
              prefixIcon={<Icons.Delete />}
            />
          </PopoverMenu>
        ),
        width: 'auto',
      },
    ];
    return (
      <TableListItem verticalPadding="small" showDivider options={options} />
    );
  };
  const options = [
    renderItem({ text: 'Define a user flow', checked: true }),
    renderItem({ text: 'Define the content', checked: false }),
    renderItem({ text: 'Prepare the wireframes', checked: false }),
  ];
  return (
    <Card>
      <Card.Header title="Tasks" />
      <Card.Divider />
      {options}
    </Card>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `checked` | `boolean` | — | Specifies whether a check is selected. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `disabled` | `boolean` | — | Specifies whether toggle interactions should be disabled. |
| `onBlur` | `(event: FocusEvent, triggers: Triggers) => void` | — |  |
| `onChange` | `ChangeEventHandler` | — | Defines a callback function which is called every time the check value is changed. |
| `onFocus` | `(event: FocusEvent, triggers: Triggers) => void` | — |  |
| `ref` | `RefObject` | — |  |
| `size` | `"small" \| "medium"` | — | Controls the size of the component. |
| `skin` | `"standard" \| "success"` | — | Controls the skin of the component. |
| `tooltipContent` | `ReactNode` | — | Defines a message to be displayed in a tooltip. Tooltip is displayed on component hover. |
| `tooltipProps` | `TooltipCommonProps` | — | Allows to pass all common tooltip props. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `isChecked` | Checks whether CheckToggle is checked |
| `click` | Clicks on the element |
| `getTooltipContent` | Gets the tooltip content, throws an error if content is not provided. |
| `exists` | Checks whether the component found with the given data hook. |
| `element` | Gets 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.330.0** (2026-09-28) — maintenance release, no component-specific changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.323.0** (2026-09-10) — maintenance release, no component-specific changes
- **1.322.0** (2026-09-09) — 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.273.0** (2026-04-30) — 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.257.0** (2026-02-19) — breaking: tokenized component ([#15941](invalid-url))
- **1.254.0** (2026-02-03) — maintenance release, no component-specific changes
- **1.250.0** (2026-01-27) — maintenance release, no component-specific changes
- **1.247.2** (2026-01-21) — maintenance release, no component-specific changes
- **1.242.0** (2025-12-19) — maintenance release, no component-specific changes
- **1.241.0** (2025-12-17) — maintenance release, no component-specific changes
- **1.212.0** (2025-08-11) — maintenance release, no component-specific changes
- **1.154.0** (2025-01-17) — maintenance release, no component-specific changes
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **1.104.1** (2024-05-14) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes