---
title: Checkbox
description: Checkboxes are used to give buyers a binary option.
source_url:
  html: https://shopify.dev/docs/api/checkout-extensions/post-purchase/components/checkbox
  md: https://shopify.dev/docs/api/checkout-extensions/post-purchase/components/checkbox.md
---

# Checkbox

Checkboxes are used to give buyers a binary option. They are commonly used to present terms and conditions.

Unlike most field components, any children passed to this component will be used as the label for the checkbox.

***

### Example

![checkbox](https://cdn.shopify.com/shopifycloud/shopify-dev/production/assets/assets/images/api/checkout-extensions/post-purchase/components/checkbox-CMMsp4Ix.png)

##### JS

```ts
import {extend, Checkbox} from '@shopify/post-purchase-ui-extensions';

extend('Checkout::PostPurchase::Render', (root) => {
  const checkbox = root.createComponent(
    Checkbox,
    {id: 'checkbox', name: 'checkbox'},
    'Save this information for next time',
  );

  root.appendChild(checkbox);
});
```

##### React

```tsx
import {render, Checkbox} from '@shopify/post-purchase-ui-extensions-react';

render('Checkout::PostPurchase::Render', () => <App />);

function App() {
  return (
    <Checkbox id="checkbox" name="checkbox">
      Save this information for next time
    </Checkbox>
  );
}
```

***

## Props

optional = ?

| Name | Type | Description |
| - | - | - |
| id? | `string` | A unique identifier for the field. When no `id` is provided, a globally unique value will be used instead. |
| name? | `string` | An identifier for the field that is unique within the nearest containing `<Form />` component. |
| value? | `boolean` | Whether the checkbox is active. This prop is an alias for `checked`, and can be useful in form libraries that provide a normalized API for dealing with both `boolean` and `string` values. If both `value` and `checked` are provided, `checked` takes precedence. |
| checked? | `boolean` | Whether the checkbox is active. |
| disabled? | `boolean` | Whether the checkbox can be changed. |
| error? | `string` | An error label to present with the field. |
| accessibilityLabel? | `string` | A label to use for the field that will be used for buyers using assistive technologies. When provided, any `children` supplied to this component are hidden from being seen for accessibility purposes to prevent duplicate content from being read. |
| onChange? | `(value: boolean) => void` | A callback that is run whenever the checkbox is changed. This callback is called with a boolean indicating whether the checkbox should now be active or inactive. This component is [controlled](https://reactjs.org/docs/forms.html#controlled-components), so you **must** store this value in state and reflect it back in the `checked` or `value` props. |

***

## Best practices

* Be framed positively: for example, Turn on notifications instead of Turn off notifications.
* Be aware of any legal issues around checkboxes - for example, to comply with GDPR, marketing sign-up checkboxes should always be deselected by default.
* Link to more information or include a subtitle as required to provide more explanation. Don't rely on tooltips to explain a checkbox.

***