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

## Article: ListItemSection Component

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

## Article Content:

# ListItemSection

_Components/Form_

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

## Overview

```jsx
<ListItemSection title="Section" />;
```

List item section allows you to group or divide list options or actions.

### Do

- Use it to build Dropdown, Multiselect, Search dropbox values or custom lists.

### Don't

- Don't use it as standalone component for general layouts. Use SectionHeader instead.

### Feature examples

#### Structure

A list item section consists of title and suffix areas.

```jsx
<ListItemSection
  title="title"
  suffix={
    <StorybookComponents.Placeholder height="24px">
      suffix
    </StorybookComponents.Placeholder>
  }
/>;
```

#### Types

Component divides lists by 4 types:

- `title` - acts as a title for list items.
- `subheader` - acts as separator between list items for differentiation
- `whitespace` - adds some padding between list items.
- `divider` - same as whitespace, but with a line.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <ListItemSection title="Section title" />
  <ListItemSection type="subheader" title="Subheader title" />
  <ListItemSection type="divider" />
  <ListItemSection type="whitespace" />
</StorybookComponents.Stack>;
```

#### Suffix

Add text, icons or a button at the end using suffix.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <ListItemSection suffix="Suffix Action" />
  <ListItemSection suffix={<InfoIcon content="Tooltip content!" />} />
</StorybookComponents.Stack>;
```

#### Text overflow

By default, text wraps into any number of lines. With `ellipsis` enabled, it will truncate to fit the width of the parent container.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <ListItemSection
    ellipsis
    title="This is a very very very very long text that will be cropped by ellipsis at some point. This is a very very very very long text that will be cropped by ellipsis at some point."
  />
  <ListItemSection title="This is a very very very very long text that will *not* be cropped by ellipsis at some point" />
</StorybookComponents.Stack>;
```

### Common use case examples

#### Grouping

Use it to group options into categories.

```jsx
<Box direction="vertical">
  <ListItemSection type="subheader" title="Most popular" />
  <ListItemSelect title="Wix Stores" />
  <ListItemSelect title="Wix Bookings" />
  <ListItemSelect title="Wix Blog" />
  <ListItemSection type="subheader" title="Other" />
  <ListItemSection title="Wix Events" />
  <ListItemSelect title="Wix Forum" />
  <ListItemSelect title="Wix Restaurants" />
</Box>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `dataHook` | `string` | — | Applied as data-hook HTML attribute that can be used in the tests. |
| `ellipsis` | `boolean` | — | If true, long text doesn't break into more than one line and is terminated with an ellipsis. |
| `onClick` | `MouseEventHandler` | — | A callback function called when suffix is clicked. |
| `suffix` | `ReactNode` | — | Suffix node. Renders TextButton for a string otherwise the node itself. |
| `title` | `ReactNode` | — | Text of the list item. |
| `type` | `"title" \| "whitespace" \| "divider" \| "subheader"` | — | A list item section can be * `title` - Acts as a title for following list items. * `subheader` - Acts as separator between list items for differentiation. * `whitespace` - Adds some padding between list items. * `divider` - Same as whitespace, but with a line. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `getTitle` | Get title Text |
| `getSuffix` | Gets suffix |
| `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.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.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.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.232.0** (2025-11-28) — maintenance release, no component-specific changes
- **1.216.0** (2025-09-01) — maintenance release, no component-specific changes
- **1.204.0** (2025-07-03) — maintenance release, no component-specific changes
- **1.172.0** (2025-03-20) — maintenance release, no component-specific changes
- **1.166.0** (2025-03-04) — breaking: list-item-section font size change in studio theme ([#14558](invalid-url))
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **1.124.0** (2024-09-06) — maintenance release, no component-specific changes
- **1.115.0** (2024-07-17) — maintenance release, no component-specific changes
- **1.103.4** (2024-05-02) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.94.0** (2024-02-14) — 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