{"title":"Menu styling reference","slug":"pos-menu-styling-reference","url":"https://support.storeconnect.com/articles/pos-menu-styling-reference","url_markdown":"https://support.storeconnect.com/articles/pos-menu-styling-reference.md","subtitle":null,"summary":"The part, attribute, and component properties for restyling the menus the POS\u0026#39;s action navigation opens with CSS, such as a group\u0026#39;s items floating from the sidebar or the bar, including the fill and the width, with tested examples such as widening the menus that open below a button, and the list of what can\u0026#39;t be styled yet.","type":"Developer_Documentation","video_url":"","keywords":"pos menu css, menu-root, data-placement, inline, below, beside, --sc-menu-bg, --sc-menu-width, navigation menu css, more menu, action group menu, pos styling api, pos parts","last_modified":"2026-11-16T23:24:18+0000","body_markdown":"A menu is a column of things a person can do, on a raised card: the items of a group in the\nnavigation, opened under the group's button or floating over the page. Follow the\n[POS styling API](pos-styling-api#rules) rules when styling it.\n\n## Where it appears\n\nThe menus the action navigation opens: a group's items floating from the sidebar or the bar,\nand a group opened inside another menu, which sits on the outer menu's card. The items are\n[list buttons](pos-list-button-styling-reference).\n\n## Parts\n\n| Part | What it is | Available from |\n| --- | --- | --- |\n| `menu-root` | The whole menu: the card with the fill, corners, and shadow, holding the items. | v22.0.13 |\n\nThe **Available from** column shows the first release that carries the name.\n\n## Attributes\n\nNarrow `menu-root` by this, inside `:where()`, to style one kind of menu.\n\n| Attribute | Values | Default | Available from |\n| --- | --- | --- | --- |\n| `data-placement` | `inline`, `below`, `beside` | `inline` | v22.0.13 |\n\n- `inline` — in the flow of what holds it, such as a group opened inside the More menu, on that menu's card\n- `below` and `beside` — floating over the page, below or beside the button that opened it\n\n## Component properties\n\nSet these on `menu-root` to change every menu, or narrow by `data-placement` to change one\nkind. A fill set on `menu-root` also replaces the fill of a group with a configured color. The\ngroup's items keep the text color chosen for the configured fill, so check that they still\nread on yours.\n\n| Property | What it sets | Default | Available from |\n| --- | --- | --- | --- |\n| `--sc-menu-bg` | The fill of the menu. It falls back to the overlay surface color, and a menu inside another to none. | none | v22.0.13 |\n| `--sc-menu-width` | The width of a floating menu. | max-content | v22.0.13 |\n\n## Examples\n\nEach example is tested against the POS on every change.\n\n**\"Give the menus a darker fill.\"**\n\n```css\n\n[part~='menu-root'] {\n  --sc-menu-bg: #e3e8ef;\n}\n```\n\n**\"Make the menus that open below their button wider.\"**\n\n```css\n\n[part~='menu-root']:where([data-placement='below']) {\n  --sc-menu-width: 280px;\n}\n```\n\n**\"Round the menus that open beside their button less.\"**\n\n```css\n\n[part~='menu-root']:where([data-placement='beside']) {\n  border-radius: 8px;\n}\n```\n\nA menu that opens below a button is square where it joins the button. A `border-radius` on it\nrounds that corner too.\n\n## What can't be styled yet\n\n- The corners of a menu inside another, such as a group opened in the More menu, which the navigation sets on the menu itself. A `background-color` set on `menu-root` doesn't reach it either; set the fill with `--sc-menu-bg`\n- The fill of the button a floating menu opens below, which joins the menu but keeps a fill of its own, so a fill set on `menu-root` doesn't reach it\n- Which side a floating menu opens toward, which follows where it is on the screen\n## Retired\n\nNone yet."}