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

## Article: ListItemAction Component

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

## Article Content:

# ListItemAction

_Components/Form_

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

## Overview

```jsx
<div
  style={{
    width: '284px',
    height: '120px',
  }}
>
  <DropdownLayout
    visible
    options={[
      listItemActionBuilder({
        id: 0,
        title: 'option 1',
      }),
      listItemActionBuilder({
        id: 1,
        title: 'option 2',
      }),
      listItemActionBuilder({
        id: 2,
        title: 'option 3',
      }),
    ]}
  />
</div>;
```

ListItemAction component is used to build menu like components.

### Do

- Use it to build navigation menus

### Don't

- Don't use it for selection based menus

### Feature examples

#### Affix

Add text, icons or a button at the beginning or end of a text field using prefixIcon and suffix.

```jsx
<div
  style={{
    width: '284px',
    height: '120px',
  }}
>
  <DropdownLayout
    visible
    options={[
      listItemActionBuilder({
        id: 0,
        prefixIcon: <Icons.Edit />,
        title: 'option 1',
        suffix: 'Suffix',
      }),
      listItemActionBuilder({
        id: 1,
        prefixIcon: <Icons.Edit />,
        title: 'option 2',
        suffix: 'Suffix',
      }),
      listItemActionBuilder({
        id: 2,
        prefixIcon: <Icons.Edit />,
        title: 'option 3',
        suffix: 'Suffix',
      }),
    ]}
  />
</div>;
```

#### Skin

List item supports three skins:

- `standard`
- `destructive`
- `premium`

```jsx
<div
  style={{
    width: '284px',
    height: '120px',
  }}
>
  <DropdownLayout
    visible
    options={[
      listItemActionBuilder({
        id: 0,
        title: 'standard',
      }),
      listItemActionBuilder({
        id: 1,
        skin: 'destructive',
        title: 'destructive',
      }),
      listItemActionBuilder({
        id: 1,
        skin: 'premium',
        title: 'premium',
      }),
    ]}
  />
</div>;
```

#### Disabled

Supports disabled state.

Optionally, tooltips on hover are available to explain disabled states with `disabledDescription`

```jsx
() => (
  <Box width="284px" height="120px" direction="vertical">
    <DropdownLayout
      visible
      options={[
        listItemActionBuilder({
          id: 0,
          title: 'Disabled with Tooltip',
          prefixIcon: <Icons.Edit />,
          disabled: true,
          disabledDescription: 'You can’t edit this item right now',
        }),
        listItemActionBuilder({
          id: 1,
          title: 'Disabled with Tooltip',
          prefixIcon: <Icons.Edit />,
          disabled: true,
          disabledDescription: 'Editing is restricted for this option',
        }),
        listItemActionBuilder({
          id: 2,
          title: 'Disabled without tooltip',
          prefixIcon: <Icons.Edit />,
          disabled: true,
        }),
      ]}
    />
  </Box>
);
```

#### Text ellipsis

Text can be set to be ellipsed on tight container width.

Tooltips on truncated text will be overridden if the component is disabled. In that case, it will show `disabledDescription` first.

```jsx
<div style={{ height: '240px' }}>
  <Layout>
    <Cell span={6}>
      <div
        style={{
          width: '200px',
          height: '120px',
        }}
      >
        <DropdownLayout
          visible
          options={[
            listItemActionBuilder({
              id: 0,
              as: 'button',
              title: 'very long message very very',
              ellipsis: true,
            }),
            listItemActionBuilder({
              id: 1,
              as: 'button',
              title: 'very long message very very',
              ellipsis: true,
            }),
            listItemActionBuilder({
              id: 2,
              as: 'button',
              disabled: true,
              disabledDescription: 'This is disabled',
              title: 'very long message very very',
              ellipsis: true,
            }),
          ]}
        />
      </div>
    </Cell>
    <Cell span={6}>
      <div
        style={{
          width: '200px',
          height: '120px',
        }}
      >
        <DropdownLayout
          visible
          options={[
            listItemActionBuilder({
              id: 0,
              as: 'button',
              title: 'very long message very',
            }),
            listItemActionBuilder({
              id: 1,
              as: 'button',
              title: 'very long message very',
            }),
            listItemActionBuilder({
              id: 2,
              as: 'button',
              title: 'very long message very',
            }),
          ]}
        />
      </div>
    </Cell>
  </Layout>
</div>;
```

#### Subtitle

A subtitle text can be set with `subtitle`

```jsx
<div
  style={{
    width: '284px',
    height: '240px',
  }}
>
  <DropdownLayout
    visible
    options={[
      listItemActionBuilder({
        id: 0,
        title: 'option 1',
        prefixIcon: <Icons.Edit />,
        subtitle: 'option 1 subtitle',
      }),
      listItemActionBuilder({
        id: 1,
        title: 'option 2',
        prefixIcon: <Icons.Edit />,
        subtitle:
          'option 2 subtitle - with a very long text that will eventually be wrapped',
      }),
      listItemActionBuilder({
        id: 2,
        ellipsis: true,
        title: 'option 3',
        prefixIcon: <Icons.Edit />,
        subtitle:
          'option 3 subtitle - with a very long text that will eventually be truncated by ellipsis',
      }),
    ]}
  />
</div>;
```

#### Advanced example

All properties work together and can be combined in various ways. It can be rendered as standalone or as part of dropdown.

```jsx
<Box height="500px">
  <DropdownLayout
    visible
    selectedId={2}
    maxHeightPixels={720}
    options={[
      listItemActionBuilder({
        id: 0,
        title: 'Edit profile',
        prefixIcon: <Icons.Edit />,
        subtitle: 'Update name or contact info',
      }),
      listItemActionBuilder({
        id: 1,
        skin: 'destructive',
        title: 'Delete account',
        prefixIcon: <Icons.Delete />,
        subtitle: 'This action can’t be undone',
      }),
      listItemActionBuilder({
        id: 2,
        disabled: true,
        title: 'Change email',
        prefixIcon: <Icons.Email />,
        subtitle: 'Requires admin approval',
        suffix: <Icons.LockLocked />,
        disabledDescription: 'You don’t have permission to change your email',
      }),
      { id: 'divider-1', value: '-' },
      listItemActionBuilder({
        id: 4,
        title: 'Manage subscriptions',
        prefixIcon: <Icons.Pages />,
        subtitle: 'Includes long text that will wrap if needed',
      }),
      listItemActionBuilder({
        id: 5,
        ellipsis: true,
        title: 'View activity log',
        prefixIcon: <Icons.Activity />,
        subtitle: 'See login and update history for this account',
      }),
      { id: 'divider-2', value: '-' },
      listItemActionBuilder({
        id: 6,
        title: 'Invite to team',
        prefixIcon: <Icons.Users />,
        subtitle: 'Send an invitation email',
        suffix: <Icons.Facebook />,
      }),
      listItemActionBuilder({
        id: 7,
        title: 'View permissions',
        prefixIcon: <Icons.LockUnlocked />,
        subtitle: 'See current role and access level',
      }),
      { id: 'divider-3', value: '-' },
      listItemActionBuilder({
        id: 8,
        size: 'small',
        title: 'Account overview',
        subtitle: 'Summary of account details',
      }),
    ]}
  />
</Box>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `as` | `"button"` | — | Render as 'button' element. |
| `autoFocus` | `boolean` | — | When present, it specifies that a button should automatically get focus when the page loads. |
| `dataHook` | `string` | — | Data attribute for testing purposes. |
| `disabled` | `boolean` | — | Specifies whether the list item is disabled. A disabled item ignores click, key down and mouse events. |
| `disabledDescription` | `string` | — | Tooltip description if item is disabled. |
| `ellipsis` | `boolean` | — | Should the text get ellipsed with tooltip, or should it get broken into lines when it reaches the end of its container. |
| `highlighted` | `boolean` | — | If true, the item is highlighted, if false - highlighted styles aren't automatically applied on item hover. |
| `onClick` | `MouseEventHandler` | — | Click event handler. |
| `onMouseEnter` | `MouseEventHandler` | — | Mouse enter event handler. |
| `onMouseLeave` | `MouseEventHandler` | — | Mouse leave event handler. |
| `prefixIcon` | `ReactElement` | — | Accepts an icon to render before the title. |
| `ref` | `null \| string \| (instance: ListItemActionRefProps \| null) => void \| RefObject<ListItemActionRefProps>` | — | Allows getting a ref to the component instance. Once the component unmounts, React will set `ref.current` to `null` (or call the ref with `null` if you passed a callback ref). |
| `shouldFocusWithoutScroll` | `boolean` | — | Specifies whether page should be scrolled to the focused item. |
| `size` | `"small" \| "medium"` | `medium` | Text Size (small, medium). |
| `skin` | `"standard" \| "destructive" \| "premium" \| "dark" \| "primary"` | `standard` | Item theme (standard, dark, destructive, premium, primary). |
| `subtitle` | `string` | — | Text of the list item subtitle. |
| `suffix` | `ReactNode` | — | Accepts any content to render after the title. |
| `suffixIcon` | `ReactElement` | — | Accepts an icon to render at the end of the list item. |
| `title` *(required)* | `ReactNode` | — | Sets the title of the list item. |
| `tooltipModifiers` | `EllipsisCommonProps` | — | Tooltip floating modifiers. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `isTitleExists` | — |
| `getTitleText` | — |
| `isPrefixIconExists` | — |
| `isSuffixIconExists` | — |
| `isSubtitleExists` | — |
| `getSubtitleText` | — |
| `isSuffixExists` | — |
| `getSuffixText` | — |
| `getSkin` | — |
| `isDisabled` | — |
| `mouseEnter` | — |
| `mouseLeave` | — |
| `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) — fix: import React in the prop types, so `listItemActionBuilder` params and `ListItemAction` props no longer resolve to `any` ([#17551](invalid-url))
- **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.337.0** (2026-10-14) — maintenance release, no component-specific changes
- **1.331.0** (2026-10-01) — maintenance release, no component-specific changes
- **1.330.0** (2026-09-28) — 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.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.323.0** (2026-09-10) — maintenance release, no component-specific changes
- **1.313.1** (2026-08-18) — maintenance release, no component-specific changes
- **1.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.298.0** (2026-07-14) — breaking: reimagine Harmony theme styling ([#16513](invalid-url)) — has visual changes
- **1.292.0** (2026-06-22) — maintenance release, no component-specific changes
- **1.277.0** (2026-05-07) — feat: add destructive skin hover tokens ([#16240](invalid-url))
- **1.273.0** (2026-04-30) — feat: add fill token and update list-item backgrounds for odeditor-dark ([#16210](invalid-url))
- **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.247.2** (2026-01-21) — maintenance release, no component-specific changes
- **1.245.0** (2026-01-06) — feat: adds onMouseEnter and onMouseLeave handlers to ListItemAction ([#15745](invalid-url))
- **1.232.0** (2025-11-28) — maintenance release, no component-specific changes
- **1.216.0** (2025-09-01) — maintenance release, no component-specific changes
- **1.213.0** (2025-08-19) — breaking: additional tokenization for editor3 ([#15198](invalid-url))
- **1.212.0** (2025-08-11) — maintenance release, no component-specific changes
- **1.205.0** (2025-07-15) — maintenance release, no component-specific changes
- **1.204.0** (2025-07-03) — maintenance release, no component-specific changes
- **1.202.0** (2025-06-27) — feat: expanded title type to ReactNode ([#15019](invalid-url))
- **1.181.0** (2025-04-18) — maintenance release, no component-specific changes
- **1.180.0** (2025-04-14) — maintenance release, no component-specific changes
- **1.176.0** (2025-04-02) — maintenance release, no component-specific changes
- **1.172.1** (2025-03-21) — maintenance release, no component-specific changes
- **1.172.0** (2025-03-20) — breaking: change List item action font size & line height in both themes ([#14586](invalid-url))
- **1.146.0** (2024-12-10) — maintenance release, no component-specific changes
- **1.124.0** (2024-09-06) — maintenance release, no component-specific changes
- **1.120.1** (2024-08-08) — maintenance release, no component-specific changes
- **1.120.0** (2024-08-02) — maintenance release, no component-specific changes
- **1.116.0** (2024-07-22) — fix: font blink and no background ([#13969](invalid-url))
- **1.116.0** (2024-07-22) — feat: add primary skin. ([#13946](invalid-url))
- **1.114.0** (2024-07-11) — maintenance release, no component-specific changes
- **1.105.0** (2024-05-21) — feat: add premium skin ([#13729](invalid-url))
- **1.104.1** (2024-05-14) — breaking: fix suffix truncation ([#13721](invalid-url))
- **1.103.1** (2024-04-24) — maintenance release, no component-specific changes
- **1.103.0** (2024-04-23) — feat: tokenized ([#13578](invalid-url))
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.100.0** (2024-04-04) — feat: add mobile breakpoint ([#13546](invalid-url))
- **1.98.0** (2024-03-15) — 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