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

## Article: ListItemEditable Component

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

## Article Content:

# ListItemEditable

_Components/Form_

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

## Overview

```jsx
() => {
  return (
    <Layout cols={1}>
      <ListItemEditable
        onApprove={() => {}}
        onCancel={() => {}}
        placeholder="Value"
        cancelButtonTooltipContent="Cancel"
        approveButtonTooltipContent="Approve"
        size="small"
        margins="none"
      />

      <ListItemEditable
        onApprove={() => {}}
        onCancel={() => {}}
        placeholder="Value"
        cancelButtonTooltipContent="Cancel"
        approveButtonTooltipContent="Approve"
        size="medium"
        margins="none"
      />
    </Layout>
  );
};
```

ListItemEditable is an internal editable component which is used to build dropdown or menu like components. Usually this item should not be used by consumers, though custom options builder is exposed for usage with DropdownBase.

### Feature examples

#### With a status

Setting a status to indicate some there's an issue.

```jsx
() => {
  return (
    <Layout cols={1}>
      <ListItemEditable
        onApprove={() => {}}
        onCancel={() => {}}
        placeholder="Value"
        cancelButtonTooltipContent="Cancel"
        approveButtonTooltipContent="Approve"
        status="error"
        margins="none"
      />

      <ListItemEditable
        onApprove={() => {}}
        onCancel={() => {}}
        placeholder="Value"
        cancelButtonTooltipContent="Cancel"
        approveButtonTooltipContent="Approve"
        status="warning"
        margins="none"
      />

      <ListItemEditable
        onApprove={() => {}}
        onCancel={() => {}}
        placeholder="Value"
        cancelButtonTooltipContent="Cancel"
        approveButtonTooltipContent="Approve"
        status="loading"
        margins="none"
      />
    </Layout>
  );
};
```

#### Part of a dropdown

The editable list item can be used alongside any other list item, build by a dedicated builder

```jsx
() => {
  return (
    <Box height="230px">
      <DropdownLayout
        visible
        options={[
          listItemSelectBuilder({
            id: 0,
            title: 'Carmel Lloyd',
          }),
          listItemSelectBuilder({
            id: 1,
            title: 'Gracie-May Marsden',
          }),
          listItemSelectBuilder({
            id: 2,
            title: 'Keisha Decker',
          }),
          listItemSelectBuilder({
            id: 3,
            title: 'Ruairidh Fitzgerald',
          }),
          listItemEditableBuilder({
            id: 4,
            onApprove: (val) => console.log(val),
            onCancel: () => console.log('cancel'),
            cancelButtonTooltipContent: 'Cancel',
            approveButtonTooltipContent: 'Approve',
          }),
          listItemSectionBuilder({ id: 5, type: 'whitespace' }),
        ]}
      />
    </Box>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `approveButtonDisabledOnEmpty` | `boolean` | `true` | Make the approve button disabled when input value is empty. |
| `approveButtonTooltipContent` | `ReactNode` | — | Approve button tooltip content. |
| `approveButtonTooltipProps` | `TooltipCommonProps` | — | Approve button tooltip common props. |
| `autoFocus` | `boolean` | — | Focus the input on mount (standard React input autoFocus) |
| `cancelButtonTooltipContent` | `ReactNode` | — | Cancel button tooltip content. |
| `cancelButtonTooltipProps` | `TooltipCommonProps` | — | Cancel button tooltip common props. |
| `dataHook` | `string` | — | Applied as data-hook HTML attribute that can be used in the tests. |
| `margins` | `"none" \| "list-item" \| "none" \| "list-item"` | — | The type of margin. |
| `maxLength` | `number` | — | Maximum number of characters allowed in the input. |
| `onApprove` | `(value: string) => void` | — | A callback function triggered by clicking the approve button. ##### Signature: function(value: string) => void * `value`: the text contained in the input. |
| `onCancel` | `() => void` | — | A callback function triggered by clicking the cancel button. ##### Signature: function() => void. |
| `onChange` | `ChangeEventHandler` | — | Defines a standard input onChange callback. |
| `onEnterPressed` | `KeyboardEventHandler<HTMLInputElement>` | — | Defines a callback handler that is called when the user presses enter on the input element. |
| `placeholder` | `string` | — | Placeholder to display. |
| `size` | `"small" \| "medium"` | — | Specifies the size of the input. |
| `status` | `"error" \| "warning" \| "loading"` | — | Input status - use to display an status indication for the user. |
| `statusMessage` | `ReactNode` | — | The status (error/loading) message to display when hovering the status icon, if not given or empty, no tooltip is displayed. |
| `suffix` | `ReactNode` | — | Pass a component you want to show as the suffix of the input, e.g., text, icon. |
| `value` | `string` | — | Initial value to display with component render. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `getValue` | A getter for the value |
| `getPlaceholder` | A getter for the placeholder |
| `isApproveButtonDisabled` | Returns true it the approve button is disabled |
| `enterText` | Simulated writing text in the input |
| `clickApprove` | Simulates clicking the approve button |
| `clickCancel` | Simulates clicking the cancel button |
| `pressEnter` | Simulates clicking the enter key |
| `isFocus` | Returns true if input element is focused |
| `hasSuffix` | Returns true if input element has suffix |
| `getCancelButtonTooltipText` | Returns cancel button tooltip text |
| `getApproveButtonTooltipText` | Returns approve button tooltip text |
| `hasStatus` | Return true if the given status is displayed |
| `getStatusMessage` | If there's a status message, returns its text value |
| `getMaxLength` | Returns the maxLength attribute value |
| `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.344.0** (2026-10-28) — maintenance release, no component-specific changes
- **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.330.3** (2026-09-29) — maintenance release, no component-specific changes
- **1.330.0** (2026-09-28) — maintenance release, no component-specific changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.320.0** (2026-09-03) — 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.267.0** (2026-04-09) — 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.256.0** (2026-02-06) — feat: add maxLength ([#15905](invalid-url))
- **1.242.0** (2025-12-19) — maintenance release, no component-specific changes
- **1.210.0** (2025-08-04) — maintenance release, no component-specific changes
- **1.172.0** (2025-03-20) — maintenance release, no component-specific changes
- **1.165.0** (2025-02-27) — maintenance release, no component-specific changes
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **1.114.0** (2024-07-11) — maintenance release, no component-specific changes
- **1.93.0** (2024-02-08) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes