{"title":"Card styling reference","slug":"pos-card-styling-reference","url":"https://support.storeconnect.com/articles/pos-card-styling-reference","url_markdown":"https://support.storeconnect.com/articles/pos-card-styling-reference.md","subtitle":null,"summary":"Every part, attribute, named card, and component property for restyling the POS\u0026#39;s cards with CSS, such as product cards in a products grid, the tiles of an action grid, and fulfillment station cards, with tested examples such as tinting only product cards, squaring their images, or marking a missing ticket, and the list of what can\u0026#39;t be styled yet.","type":"Developer_Documentation","video_url":"","keywords":"pos card css, card-root, card-surface, card-image, card-body, data-status, product-card, --sc-card-bg-color, --sc-card-radius, --sc-card-shadow, --sc-card-min-width, --sc-card-image-aspect-ratio, --sc-card-image-object-fit, temporary card, missing ticket, product grid css, pos styling api, pos parts","last_modified":"2026-11-12T23:21:16+0000","body_markdown":"A card is one tile on a POS screen, such as a product with an image, name, and price, an action\ntile, or a fulfillment station. Use this reference to restyle cards with CSS: change the fill,\ncorners, shadow, and image of every card, or of product cards only.\n\nCards shrink to fit the space they're given. A smaller card shows less information, and the\nsmallest cards show faint placeholder bars in place of text. Follow the\n[POS styling API rules](pos-styling-api#rules) when you style a card.\n\n## Where cards appear\n\nCards appear wherever a POS screen lays out records as tiles, such as the products in a products\ngrid and the tiles of an action grid. Products show as product cards, named `product-card`,\nwherever they appear: in a products grid, as product tiles in an action grid, and as the\ncomponents of a bundle. Actions, stations, and other records show as other kinds of card.\n\nEvery card has the `card-root` and `card-surface` parts. A card that shows an image also has\n`card-image`, and a card that shows text under the image has `card-body`.\n\n## How cards display\n\nInside a [layout](pos-layout-styling-reference), the layout sets the size of each card to fit\nthe cell. To change the number of columns in a grid, set `--sc-layout-item-min-width` on\n`layout-root`. Setting `--sc-card-min-width` on `layout-root` also widens the columns, but when\nboth are set, the POS uses `--sc-layout-item-min-width`.\n\nAn action tile can have a color, set in the **Color** field (`s_c__Color__c`) of the POS action\nitem. That color shows in place of `--sc-card-bg-color`, so action tiles keep their configured\ncolors when you change the fill of every card. A `background-color` rule on `card-surface` is\ndifferent: it replaces the configured colors too. To change the fill of product cards and leave\naction tiles as they are, add `product-card` to the selector, as the tint example under\n[Card styling examples](#card-styling-examples) shows.\n\n## Parts of a card\n\n| Part | What it is | Available from |\n| --- | --- | --- |\n| `card-root` | The whole card: the box a layout sizes, around the surface. The size properties take effect here. | v22.0.10 |\n| `card-surface` | The visible card: the fill, border, corners, and shadow, with the image and text inside. | v22.0.10 |\n| `card-image` | The image at the top of a card, when the card has one. | v22.0.10 |\n| `card-body` | The text under the image on a product card or an action tile, or on a card that shows a name and details. | v22.0.10 |\n\nThe **Available from** column shows the first release that carries the name.\n\n## Card attributes\n\nThe `data-status` attribute on `card-surface` marks two kinds of card that look different from\nthe rest:\n\n- `temporary` — a station card for a fulfillment station whose tickets this register is\n  printing for now, either while that station is unavailable or because the register is set up\n  to print them\n- `missing` — a ticket card for a ticket the POS couldn't find\n\nTemporary cards keep their own fill, and missing cards keep their own fill, text color, and\nborder, so operators can still tell them apart from other cards after you restyle the cards. To\nchange them, set `background-color`, `color`, or `border` on `card-surface`, and narrow the\nselector to one status inside `:where()`, as in\n`[part~='card-surface']:where([data-status='missing'])`.\n\n| Attribute | Values | Default | Available from |\n| --- | --- | --- | --- |\n| `card-surface[data-status]` | `normal`, `temporary`, `missing` | `normal` | v22.0.10 |\n\n## Product card name\n\nProduct cards carry an extra identifying name, `product-card`, beside `card-root`. It's a label\nfor your CSS selectors, not a Salesforce API name. Select `product-card` to style product cards\nwithout changing action tiles, station cards, or other cards. To reach a part inside a product\ncard, put the name first in the selector, as in `[part~='product-card'] [part~='card-surface']`.\n\n| Name | What it is | Available from |\n| --- | --- | --- |\n| `product-card` | A product's card, in a product grid, an action grid, or a bundle's components. | v22.0.10 |\n\n## Card component properties\n\nSet these properties on `card-root` to change every card, on `product-card` to change only\nproduct cards, or on `layout-root` to change the cards in a layout. They don't change every\ncolor of a temporary or missing card: the descriptions below say which colors those cards keep,\nand [Card attributes](#card-attributes) shows how to change them.\n\n| Property | What it sets | Default | Available from |\n| --- | --- | --- | --- |\n| `--sc-card-width` | How wide a card is outside a layout. Inside one, the layout sizes it. | 180px | v22.0.10 |\n| `--sc-card-min-width` | The narrowest a card gets, and the narrowest the columns of a grid layout get unless the layout's `--sc-layout-item-min-width` is set. | none | v22.0.10 |\n| `--sc-card-min-height` | The shortest a card gets. | none | v22.0.10 |\n| `--sc-card-bg-color` | The fill of a normal card, under an action tile's configured color. Temporary and missing cards keep their own. | none | v22.0.10 |\n| `--sc-card-color` | The text color of a normal or temporary card, under an action tile's configured color. Missing cards keep their own. | none | v22.0.10 |\n| `--sc-card-border` | The border of a normal or temporary card, as a border shorthand, such as `none` to remove it. Missing cards keep their own. | none | v22.0.10 |\n| `--sc-card-shadow` | The shadow under a card, as a box shadow, such as `none` to remove it. | none | v22.0.10 |\n| `--sc-card-radius` | The corners of a card, in place of the ones that grow with the card's width. | none | v22.0.10 |\n| `--sc-card-hover-bg-color` | The wash over a card while it is hovered, under an action tile's configured one. It shows at 40% opacity. | none | v22.0.10 |\n| `--sc-card-headline-weight` | The weight of the large title on an action or station card. | none | v22.0.10 |\n| `--sc-card-image-aspect-ratio` | The shape of a card's image, as width / height. | 1.3 / 1 | v22.0.10 |\n| `--sc-card-image-object-fit` | How the image fills the frame, such as `cover` to crop it or `contain` to show all of it, in place of the screen's. | none | v22.0.10 |\n| `--sc-card-image-size` | The width and height of the image's box inside the frame, in place of the screen's. | none | v22.0.10 |\n| `--sc-card-image-vignette` | The soft shadow inside the image's edges, as a box shadow, such as `none` to remove it. | none | v22.0.10 |\n\n## Card styling examples\n\nStoreConnect's automated tests run each of these examples against the POS whenever the POS\ncode changes, so they work as written.\n\n**\"Give the cards a white fill, squarer corners, and no shadow.\"**\n\n```css\n\n[part~='card-root'] {\n  --sc-card-bg-color: #ffffff;\n  --sc-card-radius: 6px;\n  --sc-card-shadow: none;\n}\n```\n\n**\"Tint the product cards, and leave the action tiles as they are.\"** Name the product cards\nfirst:\n\n```css\n\n[part~='product-card'] [part~='card-surface'] {\n  background-color: #e8f0fb;\n}\n```\n\n**\"Make a ticket that wasn't found stand out more.\"** Narrow the surface to the `missing` status:\n\n```css\n\n[part~='card-surface']:where([data-status='missing']) {\n  background-color: #fdecea;\n}\n```\n\n**\"Make the product images square, and show all of each image.\"**\n\n```css\n\n[part~='product-card'] {\n  --sc-card-image-aspect-ratio: 1;\n  --sc-card-image-object-fit: contain;\n}\n```\n\n**\"Remove the shadow inside the images' edges.\"**\n\n```css\n\n[part~='card-root'] {\n  --sc-card-image-vignette: none;\n}\n```\n\n**\"Make the columns of a grid wider.\"**\n\n```css\n\n[part~='layout-root']:where([data-variant='grid']) {\n  --sc-card-min-width: 260px;\n}\n```\n\n## What can't be styled on a card yet\n\n- The text on a card, such as a product's name and code, on its own\n- The tag, the quantity buttons, and the variant menu on a product card\n- The header and preview on a station card\n- The body of a card that shows custom content, such as an action with a custom view\n- How the smallest cards hide or redact the text\n- The shape of a product card's image when it shows several, as some of a bundle's components do\n- The layout of a card, such as a list card with the image beside the text\n\n## Retired card names\n\nNone yet."}