ListItemSection

Components/Form

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

Overview

Copy

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.

Copy

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

Suffix

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

Copy

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.

Copy

Common use case examples

Grouping

Use it to group options into categories.

Copy

Code

Copy

Props

NameTypeDefaultDescription
dataHookstring—Applied as data-hook HTML attribute that can be used in the tests.
ellipsisboolean—If true, long text doesn't break into more than one line and is terminated with an ellipsis.
onClickMouseEventHandler—A callback function called when suffix is clicked.
suffixReactNode—Suffix node. Renders TextButton for a string otherwise the node itself.
titleReactNode—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:

Copy

Driver methods

MethodDescription
getTitleGet title Text
getSuffixGets suffix
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns 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)
  • 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

Last updated: 21 October 2026

Did this help?