> ## 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.

# <RadioGroup />

> A radio group input field for selecting a single option from a list.

<img className="dark:hidden" width="720" height="440" noZoom src="https://mintcdn.com/attio/MtV7U9CRhT0ouJbz/images/radio-group.png?fit=max&auto=format&n=MtV7U9CRhT0ouJbz&q=85&s=06a9447b217bcf4bf568899d1c61a84b" data-path="images/radio-group.png" />

<img className="hidden dark:block" width="720" height="440" noZoom src="https://mintcdn.com/attio/MtV7U9CRhT0ouJbz/images/radio-group-dark.png?fit=max&auto=format&n=MtV7U9CRhT0ouJbz&q=85&s=d8c27158ee560f199d605c9b5af5ee24" data-path="images/radio-group-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, Experimental_RadioGroup: RadioGroup} = useWorkspaceSettingsForm()

  return (
    <Form>
      <RadioGroup name="sync_frequency">
        <RadioGroup.Item value="hourly" label="Hourly" />
        <RadioGroup.Item value="daily" label="Daily" />
        <RadioGroup.Item value="weekly" label="Weekly" />
      </RadioGroup>
    </Form>
  )
}
```

## Adding a legend

To add a legend to your radio group, wrap it in a [`<Fieldset />`](./fieldset):

```tsx theme={"system"}
<Fieldset legend="Sync frequency">
  <RadioGroup name="sync_frequency">
    <RadioGroup.Item value="hourly" label="Hourly" />
    <RadioGroup.Item value="daily" label="Daily" />
  </RadioGroup>
</Fieldset>
```

## Props

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

  e.g. `"sync_frequency"`, `"notifications.method"`
</ParamField>

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

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

<ParamField path="children" type="React.ReactNode" required>
  The `<RadioGroup.Item />`s representing the available options.

  <Tip>
    A `<RadioGroup />` component should only have `<RadioGroup.Item />`s as children.
  </Tip>
</ParamField>

# `<RadioGroup.Item />`

A radio group item representing a single selectable option.

## Props

<ParamField path="value" type="string" required>
  The value of the radio item that will be stored in the settings when selected.
</ParamField>

<ParamField path="label" type="string" required>
  The label displayed next to the radio item.
</ParamField>
