Range

Components/Form/Range

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

Overview

Copy

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.

Copy

Range type

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

Copy

Common use case examples

Disabled start or end of a range

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

Copy

Multiple values

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

Copy

Code

Copy

Props

NameTypeDefaultDescription
childrenReactNode—Accept any component as a child item. At the moment it is most commonly used with <DatePicker/> or <Input/>
dataHookstring—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

Last updated: 22 October 2026

Did this help?