InputShell

Components/Form

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

Overview

Copy

Input shell is an atomic input component. It can replace the regular <Input/> or <Dropdown/> components when you need a value that isn't a string, such as in a font dropdown.

Do

  • Use <InputShell/> to preview non-string values.

Don't

  • Don't use it to show simple string values. Use <Input/> or <Dropdown/> instead.

Feature examples

Size

Adjust the size of the input using the size prop. It supports 3 sizes:

  • For most common cases, use the default medium.
  • To emphasize specific inputs in onboarding flows, use large.
  • Use small for more dense and compact layouts.
Copy

Use menuArrow prop to change InputShell to look like a Dropdown.

Copy

Disabled

disabled removes all interactions and creates a disabled input state. Use it to highlight functions that are unavailable.

Copy

Render as

<InputShell/> can be rendered as div or as button

Copy

Developer examples

Masked InputShell using use-mask-input

Requires use of external package. In this example use-mask-input package is used.

Copy

Common use case examples

Border style

To show border style in the dropdown you can use <InputShell/> as a div and use css or even an svg to create such designs.

Copy

Code

Copy

Props

NameTypeDefaultDescription
as"button" | "div"—Renders the component as button.
childrenReactNode—Allows to render any component as a child item.
dataHookstring—Applies a data-hook HTML attribute to be used in the tests.
focusedfalse | true | "auto"—Controls visual focus state.
menuArrowbooleanfalseSpecifies whether input should have a dropdown menu arrow on the right side.
onClickMouseEventHandler<HTMLButtonElement> | MouseEventHandler<HTMLDivElement>—A callback function called on component click.
placeholderReactNode—Sets a placeholder message to display.
size"small" | "tiny" | "medium" | "large"—Controls the size of the input. Default value: medium

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
getTagNameReturns the tag name of the HTML element
hasMenuArrowReturns true if dropdown arrow is displayed
isDisabled—
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns UniDriver for the base element.

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.329.0 (2026-09-24) — maintenance release, no component-specific changes
  • 1.328.0 (2026-09-22) — maintenance release, no component-specific changes
  • 1.326.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.323.0 (2026-09-10) — 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.273.0 (2026-04-30) — 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.254.0 (2026-02-03) — maintenance release, no component-specific changes
  • 1.247.2 (2026-01-21) — maintenance release, no component-specific changes
  • 1.242.0 (2025-12-19) — maintenance release, no component-specific changes
  • 1.241.0 (2025-12-17) — maintenance release, no component-specific changes
  • 1.224.0 (2025-10-30) — maintenance release, no component-specific changes
  • 1.216.0 (2025-09-01) — maintenance release, no component-specific changes
  • 1.212.0 (2025-08-11) — maintenance release, no component-specific changes
  • 1.207.0 (2025-07-24) — maintenance release, no component-specific changes
  • 1.184.0 (2025-04-30) — feat: add isDisabled to unidriver (#14776)
  • 1.182.0 (2025-04-23) — feat: add placeholder and size props (#14728)
  • 1.171.0 (2025-03-14) — fix: add font css (#14603)
  • 1.169.0 (2025-03-10) — maintenance release, no component-specific changes
  • 1.158.0 (2025-02-04) — fix: fix prop types for focused prop in InputShell (#14496)
  • 1.146.2 (2024-12-10) — fix: fix overflow when ellipsis (#14372)
  • 1.146.0 (2024-12-10) — fix: fixed InputShell menu arrow position for button (#14368)
  • 1.145.0 (2024-12-09) — fix: fix InputShell menu arrow position (#14348)
  • 1.134.0 (2024-10-18) — feat: add InputShell component (#14210)

Last updated: 22 October 2026

Did this help?