> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# <Checkbox />

> A checkbox input field.

<img className="dark:hidden" width="720" height="440" noZoom src="https://mintcdn.com/attio/jXl5_SFM_Le7vWWN/images/workspace-settings-checkbox.png?fit=max&auto=format&n=jXl5_SFM_Le7vWWN&q=85&s=e2eed51d43285ed3258333242be69b08" data-path="images/workspace-settings-checkbox.png" />

<img className="hidden dark:block" width="720" height="440" noZoom src="https://mintcdn.com/attio/jXl5_SFM_Le7vWWN/images/workspace-settings-checkbox-dark.png?fit=max&auto=format&n=jXl5_SFM_Le7vWWN&q=85&s=4ff63e9e5ea1c3431543ce57f713ec51" data-path="images/workspace-settings-checkbox-dark.png" />

<Note>
  This component is returned by
  [`useWorkspaceSettingsForm()`](../../settings/use-workspace-settings-form).
</Note>

## Example

```tsx workspace-settings.tsx theme={"system"}
import React from "react"
import {useWorkspaceSettingsForm} from "attio/client"
import type {App} from "attio"

export const workspaceSettings: App.Settings.Workspace = {
  Page,
}

function Page() {
  const {Form, Checkbox} = useWorkspaceSettingsForm()

  return (
    <Form>
      <Checkbox label="Enable automatic sync" name="auto_sync_enabled" />
    </Form>
  )
}
```

## Grouping multiple checkboxes

To group multiple related checkboxes together under a legend, wrap them in a [`<Fieldset />`](./fieldset):

```tsx theme={"system"}
<Fieldset legend="Notification channels">
  <Checkbox label="Email notifications" name="email_notifications" />
  <Checkbox label="SMS notifications" name="sms_notifications" />
  <Checkbox label="Push notifications" name="push_notifications" />
</Fieldset>
```

## Props

<ParamField path="label" type="string" required>
  The label of the input field.
</ParamField>

<ParamField path="name" type="string" required>
  The path to the `boolean` value of the input field in your [settings schema](../../settings/app-settings-schema).

  e.g. `"auto_sync_enabled"`, `"notifications.email_enabled"`
</ParamField>

<ParamField path="disabled" type="boolean">
  Whether or not the field should be disabled.

  Defaults to `false` (not disabled).
</ParamField>