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

## Article: ListItemSelectIcon Component

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

## Article Content:

# ListItemSelectIcon

_Components/Form_

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

## Overview

```jsx
() => {
  const [selectedId, setSelectedId] = React.useState(null);

  const items = [
    { id: 1, icon: <Icons.FaceSmiling />, label: 'Happy' },
    { id: 2, icon: <Icons.Heart />, label: 'Love' },
    { id: 3, icon: <Icons.Star />, label: 'Favorite' },
    { id: 4, icon: <Icons.Flag />, label: 'Flagged' },
  ];

  const selectedItem = items.find((item) => item.id === selectedId);

  const options = items.map((item) =>
    listItemSelectIconBuilder({
      ...item,
      showTooltip: true,
    }),
  );

  return (
    <Box width="200px" padding="20px" gap="20px" direction="vertical">
      <Dropdown
        placeholder="Select an icon"
        options={options}
        selectedId={selectedId}
        onSelect={(option) => setSelectedId(option.id)}
        prefix={
          selectedItem ? (
            <Input.IconAffix>{selectedItem.icon}</Input.IconAffix>
          ) : undefined
        }
        popoverProps={{ appendTo: 'window' }}
      />
    </Box>
  );
};
```

`<ListItemSelectIcon/>` is an icon-only selectable list item designed for use in icon pickers, formatting toolbars, and dropdown menus where visual options can be represented by icons alone.

### Do

- Use it inside `<Dropdown/>` with listItemSelectIconBuilder for consistent option rendering.
- Use it for options that are universally recognizable by icon alone, such as alignment, bold and italic, or shapes.
- Provide a `<Tooltip/>` when the icon's meaning isn't immediately obvious, so users can hover to learn what each option represents.

### Don't

- Don't use it when the option needs a text label to be understood. Use `<ListItemSelect/>` instead.
- Don't mix `<ListItemSelectIcon/>` and `<ListItemSelect/>` in the same list. They have different visual footprints and serve different use cases.
- Don't pass interactive elements, such as buttons or links, as the icon prop. The entire component is already clickable.

### Feature examples

#### Selected

Indicate which item is chosed with `selected` prop.

```jsx
() => {
  const [selectedId, setSelectedId] = React.useState('favorite');

  const icons = [
    { id: 'favorite', icon: <Icons.Favorite />, label: 'Favorite' },
    { id: 'heart', icon: <Icons.Heart />, label: 'Heart' },
  ];

  return (
    <Box width="200px" direction="vertical" padding="20px" gap="4px">
      {icons.map(({ id, icon, label }) => (
        <ListItemSelectIcon
          key={id}
          icon={icon}
          label={label}
          selected={selectedId === id}
          onClick={() => setSelectedId(id)}
        />
      ))}
    </Box>
  );
};
```

#### Size

Item size depends on the icon provided. If a small icon is used, the list item will automatically adjust its size to fit.

```jsx
() => {
  const [selectedId, setSelectedId] = React.useState(null);

  const icons = [
    { id: 'favorite', icon: <Icons.Favorite />, label: 'Favorite' },
    { id: 'heart', icon: <Icons.HeartSmall />, label: 'Heart' },
  ];

  return (
    <Box width="200px" direction="vertical" padding="20px" gap="4px">
      {icons.map(({ id, icon, label }) => (
        <ListItemSelectIcon
          key={id}
          icon={icon}
          label={label}
          selected={selectedId === id}
          onClick={() => setSelectedId(id)}
        />
      ))}
    </Box>
  );
};
```

#### Disabled

Component can be disabled, it automatically changes color of all areas if used as text or icon.

```jsx
() => {
  const [selectedId, setSelectedId] = React.useState('favorite');

  const icons = [
    { id: 'favorite', icon: <Icons.Favorite />, label: 'Favorite' },
    { id: 'heart', icon: <Icons.Heart />, label: 'Heart', disabled: true },
  ];

  return (
    <Box width="200px" direction="vertical" padding="20px" gap="4px">
      {icons.map(({ id, icon, label, disabled }) => (
        <ListItemSelectIcon
          key={id}
          icon={icon}
          label={label}
          disabled={disabled}
          selected={selectedId === id}
          onClick={() => setSelectedId(id)}
        />
      ))}
    </Box>
  );
};
```

#### Custom content

Pass custom content in the item depending on your use-case. You can construct any dropdown based selection list, from status selector with `<Badges/>` or color selector when needed.

```jsx
() => {
  const [selectedId, setSelectedId] = React.useState('icon');

  const items = [
    {
      id: 'icon',
      icon: <Icons.Favorite />,
      label: 'Favorite icon',
    },
    {
      id: 'avatar',
      icon: <Avatar size="size24" name="John Doe" />,
      label: 'User avatar',
    },
    {
      id: 'badge',
      icon: <Badge skin="standard">Badge</Badge>,
      label: 'Notifications badge',
    },
  ];

  return (
    <Box width="200" direction="vertical" padding="20px" gap="4px">
      {items.map(({ id, icon, label }) => (
        <ListItemSelectIcon
          key={id}
          icon={icon}
          label={label}
          onClick={() => setSelectedId(id)}
        />
      ))}
    </Box>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `dataHook` | `string` | — | Applied as data-hook HTML attribute that can be used in the tests. |
| `disabled` | `boolean` | — | If true, the item is disabled. |
| `highlighted` | `boolean` | — | If true, the item is highlighted. |
| `icon` *(required)* | `ReactNode` | — | Icon of the list item. |
| `label` *(required)* | `string` | — | Label of the list item. |
| `onClick` | `MouseEventHandler` | — | Callback function triggered when list item is clicked. |
| `selected` | `boolean` | — | If true, the item is selected. |
| `showTooltip` | `boolean` | — | If true, the tooltip is shown on hover. |
| `tooltipProps` | `Omit<TooltipProps, "children" \| "disabled" \| "content">` | — | Allows to pass all common tooltip props. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `isSelected` | — |
| `getAriaLabel` | — |
| `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.330.3** (2026-09-29) — 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.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.266.0** (2026-04-07) — maintenance release, no component-specific changes
- **1.263.0** (2026-03-31) — feat: add border-radius token support ([#16072](invalid-url)) — has visual changes
- **1.260.1** (2026-03-23) — 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.182.0** (2025-04-23) — fix: make content have full width ([#14767](invalid-url))
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **1.135.0** (2024-10-23) — feat: add ListItemSelectIcon component ([#14221](invalid-url))