{"title":"List button styling reference","slug":"pos-list-button-styling-reference","url":"https://support.storeconnect.com/articles/pos-list-button-styling-reference","url_markdown":"https://support.storeconnect.com/articles/pos-list-button-styling-reference.md","subtitle":null,"summary":"Every part, attribute, and component property for restyling the items of the POS\u0026#39;s navigation and menus with CSS, such as the action items in the sidebar and the bar, the More button, and the items a group opens, with tested examples such as darkening the navigation\u0026#39;s text or coloring the icons, and the list of what can\u0026#39;t be styled yet.","type":"Developer_Documentation","video_url":"","keywords":"pos navigation item css, list-button-root, list-button-media, list-button-leading-icon, list-button-badge, list-button-label, list-button-chevron, list-button-tooltip, list-button-loading-indicator, data-variant, data-layout, --sc-list-button-bg, --sc-list-button-color, --sc-list-button-max-width, sidebar item css, menu item css, pos styling api, pos parts","last_modified":"2026-11-16T23:49:08+0000","body_markdown":"POS users tap list buttons to move between POS functions. List buttons appear in the sidebar,\nin the top bar, and in menus such as the **More** menu. Use this reference to style list\nbuttons, following the [POS styling API](pos-styling-api#rules) rules.\n\n## Where list buttons appear\n\n- Each action item in the sidebar and the top bar\n- The **More** button, which opens the remaining actions\n- The button that collapses the sidebar\n- The cart button on the top bar\n- The items in a [menu](pos-menu-styling-reference), such as the items a group opens\n\nAn item that opens a group shows a chevron. The item for the page the user is on is\nhighlighted.\n\n## Parts of a list button\n\n| Part | What it is | Available from |\n| --- | --- | --- |\n| `list-button-root` | The whole item, with the fill and corners. | v22.0.14 |\n| `list-button-media` | The box before the label that holds the icon or picture, the badge, and the spinner while the item loads. | v22.0.14 |\n| `list-button-leading-icon` | The Icon in the media, when the item shows one. | v22.0.14 |\n| `list-button-badge` | The badge pinned to the media, when it has one. It is a Badge, so it reads the Badge properties. | v22.0.14 |\n| `list-button-label` | The text. Not shown on an icon-only item. | v22.0.14 |\n| `list-button-chevron` | The chevron on an item that opens a group, which turns while the group is open. | v22.0.14 |\n| `list-button-tooltip` | The label an icon-only item shows on hover and keyboard focus. | v22.0.14 |\n| `list-button-loading-indicator` | The spinner that stands in for the media while the item loads. | v22.0.14 |\n\nThe **Available from** column shows the first release that carries the name.\n\n## Attributes of a list button\n\nNarrow `list-button-root` by these, inside `:where()`, to style one kind of item.\n\n| Attribute | Values | Default | Available from |\n| --- | --- | --- | --- |\n| `data-variant` | `text`, `tonal` | `text` | v22.0.14 |\n| `data-layout` | `row`, `stacked`, `icon` | `row` | v22.0.14 |\n\n- `text` — no fill of its own. The page a person is on takes the primary soft fill\n- `tonal` — a fill, an action's configured color or the primary soft pair. The page a person is on wears a ring\n- `row` — the label beside the media\n- `stacked` — a small label under the media, in a narrow rail\n- `icon` — the media alone, with the label as the item's name\n\n## Component properties\n\nSet these on `list-button-root` to change every item, or narrow by an attribute to change one\nkind. An action item with a configured color keeps it over the fill and color properties, as\nan action tile does on a card. The items in a colored group's menu take the group's text\ncolor, unless a color is set on them. The fill also reaches the button of an open group, in\nplace of the fill it takes from a floating menu under it, so the two no longer match.\n\n| Property | What it sets | Default | Available from |\n| --- | --- | --- | --- |\n| `--sc-list-button-bg` | The fill of the item, under an action's configured color. The page a person is on keeps the primary soft fill on a text item. | none | v22.0.14 |\n| `--sc-list-button-color` | The text and icon color, under an action's configured color. | none | v22.0.14 |\n| `--sc-list-button-max-width` | The widest a stacked item grows, so a long label truncates instead of widening the rail. | 64px | v22.0.14 |\n\n## List button examples\n\nEach example is tested against the POS on every change.\n\n**\"Make the navigation's text darker.\"**\n\n```css\n\n[part~='list-button-root'] {\n  --sc-list-button-color: #1f2933;\n}\n```\n\n**\"Give the plain items a light fill, with dark text.\"**\n\n```css\n\n[part~='list-button-root']:where([data-variant='text']) {\n  --sc-list-button-bg: #e3e8ef;\n  --sc-list-button-color: #1f2933;\n}\n```\n\n**\"Let the items in the narrow rail grow wider.\"**\n\n```css\n\n[part~='list-button-root']:where([data-layout='stacked']) {\n  --sc-list-button-max-width: 80px;\n}\n```\n\n**\"Make the labels bolder.\"**\n\n```css\n\n[part~='list-button-label'] {\n  font-weight: 600;\n}\n```\n\n**\"Color the icons.\"**\n\n```css\n\n[part~='list-button-leading-icon'] {\n  color: #0b5394;\n}\n```\n\n## What can't be styled yet\n\n- An action item's configured color, which sits over the fill and color properties\n- The current page, an open group, a loading item, and a disabled item, which have no listed attribute yet\n- The wash over an item while it's hovered or pressed\n\n## Retired\n\nNone yet."}