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

## Article: InputShell Component

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

## Article Content:

# InputShell

_Components/Form_

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

## Overview

```jsx
() => {
  const divStyle = {
    fontFamily: 'Impact, sans-serif',
    fontWeight: 'bold',
  };

  return (
    <Box align="center">
      <Box direction="vertical" width="30%">
        <FormField label="Font">
          <InputShell menuArrow>
            <div style={divStyle}>Impact</div>
          </InputShell>{' '}
        </FormField>
      </Box>
    </Box>
  );
};
```

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.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <InputShell size="large" placeholder="Large" />
  <InputShell size="medium" placeholder="Medium" />
  <InputShell size="small" placeholder="Small" />
</StorybookComponents.Stack>;
```

#### Menu arrow

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

```jsx
<StorybookComponents.Stack flexDirection="column">
  <InputShell placeholder="No dropdown arrow" />
  <InputShell placeholder="With drodown arrow" menuArrow />
</StorybookComponents.Stack>;
```

#### Disabled

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

```jsx
<InputShell disabled={true}>Disabled</InputShell>;
```

#### Render as

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

```jsx
<StorybookComponents.Stack flexDirection="column">
  <InputShell
    as="div"
    placeholder="Rendered as div"
    dataHook="as-div-example"
  />
  <InputShell
    as="button"
    placeholder="Rendered as button"
    dataHook="as-button-example"
  />
</StorybookComponents.Stack>;
```

### Developer examples

#### Masked InputShell using use-mask-input

_Requires use of external package. In this example `use-mask-input` package is used._

```jsx
() => {
  const { withMask } = require('use-mask-input');
  const maskRef = React.useMemo(
    () =>
      withMask('99 / 99', {
        placeholder: '_',
        showMaskOnHover: false,
      }),
    [],
  );
  return (
    <InputShell>
      <Input border="none" placeholder="MM / YY" inputRef={maskRef} />
    </InputShell>
  );
};
```

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

```jsx
() => {
  const [opacity, setOpacity] = React.useState(50);

  return (
    <SidePanel onCloseButtonClick={() => {}} skin="floating" width="288px">
      <SidePanel.Header title="Design" />
      <SidePanel.Content>
        <FieldSet
          suffix={
            <ToggleButton labelValue="Small" size="tiny">
              <Icons.AdjustSmall />
            </ToggleButton>
          }
          legend="Borders"
          legendSize="small"
          legendPlacement="top"
          alignment="center"
          columns="32px auto 120px"
        >
          <div style={{ height: '32px' }}>
            <FillPreview fill="#000000" aspectRatio={1} />{' '}
          </div>
          <NumberInput
            value={opacity}
            min={0}
            max={10}
            onChange={(value) => setOpacity(value)}
            suffix={<Input.Affix>px</Input.Affix>}
            hideStepper
          />
          <InputShell menuArrow>
            <div
              style={{
                height: '20px',
                width: '80px',
                alignItems: 'center',
                justifyContent: 'center',
              }}
            >
              <div
                style={{
                  height: '10px',
                  borderBottom: '2px solid black',
                }}
              ></div>
            </div>
          </InputShell>
        </FieldSet>
      </SidePanel.Content>
    </SidePanel>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `as` | `"button" \| "div"` | — | Renders the component as button. |
| `children` | `ReactNode` | — | Allows to render any component as a child item. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute to be used in the tests. |
| `focused` | `false \| true \| "auto"` | — | Controls visual focus state. |
| `menuArrow` | `boolean` | `false` | Specifies whether input should have a dropdown menu arrow on the right side. |
| `onClick` | `MouseEventHandler<HTMLButtonElement> \| MouseEventHandler<HTMLDivElement>` | — | A callback function called on component click. |
| `placeholder` | `ReactNode` | — | 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:

```jsx
// UniDriver
import { InputShellUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { InputShellTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { InputShellTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { InputShellTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### Driver methods

| Method | Description |
| --- | --- |
| `getTagName` | Returns the tag name of the HTML element |
| `hasMenuArrow` | Returns true if dropdown arrow is displayed |
| `isDisabled` | — |
| `exists` | Checks whether the component found with the given data hook. |
| `element` | Gets the component root element. |
| `click` | Clicks on the component root element. |
| `base` | Returns 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](invalid-url))
- **1.182.0** (2025-04-23) — feat: add placeholder and size props ([#14728](invalid-url))
- **1.171.0** (2025-03-14) — fix: add font css ([#14603](invalid-url))
- **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](invalid-url))
- **1.146.2** (2024-12-10) — fix: fix overflow when ellipsis ([#14372](invalid-url))
- **1.146.0** (2024-12-10) — fix: fixed InputShell menu arrow position for button ([#14368](invalid-url))
- **1.145.0** (2024-12-09) — fix: fix InputShell menu arrow position ([#14348](invalid-url))
- **1.134.0** (2024-10-18) — feat: add InputShell component ([#14210](invalid-url))