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

## Article: Range Component

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

## Article Content:

# Range

_Components/Form/Range_

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

## Overview

```jsx
() => {
  const [fromValue, setFromValue] = React.useState(new Date());
  const [toValue, setToValue] = React.useState(null);

  return (
    <FormField
      label="Valid between"
      infoContent="Set when coupon code is valid from and when it expires."
    >
      <Range>
        <DatePicker
          placeholderText="From"
          value={fromValue}
          onChange={setFromValue}
        />
        <DatePicker
          placeholderText="To"
          value={toValue}
          onChange={setToValue}
        />
      </Range>
    </FormField>
  );
};
```

Range allows users to enter a range of values or dates. It's a container that wraps and merges two input fields such as `<Input/>` \` or `<Datepicker/>`.

### Do

- Use it to specify a range of dates
- Use it to specify a range of numeric values such as duration

### Don't

- Don't use it to merge dependent fields, i.e. price input with currency selection. Use `<Layout/>` to place inputs in 12px proximity to one another.

### Feature examples

#### Structure

Component is an empty container that merges two input fields horizontally.

```jsx
<Range>
  <StorybookComponents.Placeholder>First Input</StorybookComponents.Placeholder>
  <StorybookComponents.Placeholder>
    Second Input
  </StorybookComponents.Placeholder>
</Range>;
```

#### Range type

Accept three types of data inputs as child elements:\
 - `<DatePicker/>`\
 - `<NumberInput/>`\
 - `<Input/>` \` - use with number values only.

```jsx
() => {
  const [fromDate, setFromDate] = React.useState(null);
  const [toDate, setToDate] = React.useState(null);

  return (
    <StorybookComponents.Stack flexDirection="column">
      <Range>
        <DatePicker
          placeholderText="Date"
          value={fromDate}
          onChange={setFromDate}
        />
        <DatePicker
          placeholderText="Date"
          value={toDate}
          onChange={setToDate}
        />
      </Range>
      <Range>
        <NumberInput placeholder="Number" />
        <NumberInput placeholder="Number" />
      </Range>
      <Range>
        <Input placeholder="Input" type="number" />
        <Input placeholder="Input" type="number" />
      </Range>
    </StorybookComponents.Stack>
  );
};
```

### Common use case examples

#### Disabled start or end of a range

Control interaction states per each field - make it disabled, readOnly, etc.

```jsx
() => {
  const [fromDate, setFromDate] = React.useState(null);
  const [toDate, setToDate] = React.useState(null);
  const [toDateDisabled, setToDateDisabled] = React.useState(false);

  const renderRange = () => (
    <Range>
      <DatePicker
        placeholderText="From"
        value={fromDate}
        onChange={setFromDate}
      />
      <DatePicker
        placeholderText={toDateDisabled ? '--/--/----' : 'To'}
        disabled={toDateDisabled}
        value={toDate}
        onChange={setToDate}
      />
    </Range>
  );

  const renderDateDisabledCheckbox = () => (
    <Checkbox
      checked={toDateDisabled}
      onChange={() => setToDateDisabled(!toDateDisabled)}
    >
      Don't set an end date
    </Checkbox>
  );

  return (
    <FormField
      label="Valid between"
      infoContent="Set when the coupon is valid from and when it expires."
    >
      <Box gap="24px">
        {renderRange()}
        {renderDateDisabledCheckbox()}
      </Box>
    </FormField>
  );
};
```

#### Multiple values

Use range to control a single entity that is combined from two values, e.g. duration from hours and minutes.

```jsx
() => {
  const [hours, setHours] = React.useState(4);
  const [minutes, setMinutes] = React.useState(15);

  return (
    <Box gap="15px">
      <FormField label="Session Duration">
        <Range>
          <NumberInput
            suffix={<Input.Affix>Hrs</Input.Affix>}
            value={hours}
            onChange={setHours}
          />
          <NumberInput
            suffix={<Input.Affix>Min</Input.Affix>}
            value={minutes}
            onChange={setMinutes}
          />
        </Range>
      </FormField>
      <FormField
        label="Buffer Time"
        infoContent="Adding a few minutes after each session is a good way to create short breaks."
      >
        <Dropdown
          placeholder="Select"
          options={[
            { id: 0, value: '5 min' },
            { id: 1, value: '10 min' },
            { id: 2, value: '15 min' },
            { id: 2, value: '20 min' },
          ]}
        />
      </FormField>
    </Box>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `children` | `ReactNode` | — | Accept any component as a child item. At the moment it is most commonly used with `<DatePicker/>` or `<Input/>` |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |

## Testkit

No testkit for this component — it doesn't expose a unidriver testkit.

## 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.326.0** (2026-09-17) — 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.291.0** (2026-06-19) — maintenance release, no component-specific changes
- **1.288.0** (2026-06-15) — maintenance release, no component-specific changes
- **1.278.0** (2026-05-08) — maintenance release, no component-specific changes
- **1.272.0** (2026-04-27) — 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.207.0** (2025-07-24) — maintenance release, no component-specific changes
- **1.172.1** (2025-03-21) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes