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

# Radio

<Frame>
  <img src="https://mintcdn.com/twenty/JIRRbviz5phT8G2L/images/user-guide/create-workspace/workspace-cover.png?fit=max&auto=format&n=JIRRbviz5phT8G2L&q=85&s=02024f4200aaf4b09a3b0caef02de198" alt="Header" width="1440" height="680" data-path="images/user-guide/create-workspace/workspace-cover.png" />
</Frame>

Used when users may only choose one option from a series of options.

<Tabs>
  <Tab title="Usage">
    ```jsx theme={null}
    import { Radio } from "twenty-ui/display";

    export const MyComponent = () => {

      const handleRadioChange = (event) => {
        console.log("Radio button changed:", event.target.checked);
      };

      const handleCheckedChange = (checked) => {
        console.log("Checked state changed:", checked);
      };


      return (
        <Radio
          checked={true}
          value="Option 1"
          onChange={handleRadioChange}
          onCheckedChange={handleCheckedChange}
          size="large"
          disabled={false}
          labelPosition="right"
        />
      );
    };

    ```
  </Tab>

  <Tab title="Props">
    | Props           | Type                   | Description                                                                                      |
    | --------------- | ---------------------- | ------------------------------------------------------------------------------------------------ |
    | style           | `React.CSS` properties | Additional inline styles for the component                                                       |
    | className       | string                 | Optional CSS class for additional styling                                                        |
    | checked         | boolean                | Indicates whether the radio button is checked                                                    |
    | value           | string                 | The label or text associated with the radio button                                               |
    | onChange        | function               | The function called when the selected radio button is changed                                    |
    | onCheckedChange | function               | The function called when the `checked` state of the radio button changes                         |
    | size            | string                 | The size of the radio button. Options include: `large` and `small`                               |
    | disabled        | boolean                | If `true`, the radio button is disabled and not clickable                                        |
    | labelPosition   | string                 | The position of the label text relative to the radio button. Has two options: `left` and `right` |
  </Tab>
</Tabs>

## Radio Group

Groups together related radio buttons.

<Tabs>
  <Tab title="Usage">
    ```jsx theme={null}
    import React, { useState } from "react";
    import { Radio, RadioGroup } from "twenty-ui/display";

    export const MyComponent = () => {

      const [selectedValue, setSelectedValue] = useState("Option 1");

      const handleChange = (event) => {
        setSelectedValue(event.target.value);
      };
      
      return (
        <RadioGroup value={selectedValue} onChange={handleChange}>
          <Radio value="Option 1" />
          <Radio value="Option 2" />
          <Radio value="Option 3" />
        </RadioGroup>
      );
    };

    ```
  </Tab>

  <Tab title="Props">
    | Props         | Type              | Description                                                                        |
    | ------------- | ----------------- | ---------------------------------------------------------------------------------- |
    | value         | string            | The value of the currently selected radio button                                   |
    | onChange      | function          | The callback function triggered when the radio button is changed                   |
    | onValueChange | function          | The callback function triggered when the selected value in the group changes.      |
    | children      | `React.ReactNode` | Allows you to pass React components (such as Radio) as children to the Radio Group |
  </Tab>
</Tabs>