Skip to documentation

Cart items

Placement and available controls for the Cart items block.

Where to find it

This block is used inside its supported parent. Open the parent section to edit it.

Usage notes

Renders line-level discount titles as blue tags below the price (e.g. BOGO, Buy 1 Get 1 Free).

Green pill shown under the product title when an item is free (price = 0). Example: '2 Free Gifts'.

Editor controls

Conditional controls appear after choosing the relevant source, style or option. Saved values may differ from new defaults.

Item surface
Choose the presentation or source that fits this component.Options: Plain rows · Individual cards
Card paddingConditional
Adjust within the range offered by the theme editor.
Card radiusConditional
Adjust within the range offered by the theme editor.
Color source
Theme colors use Color DNA, Color scheme uses a shared Shopify preset, and Custom affects only this block.Options: Theme colors · Color scheme · Custom
Color schemeConditional
Choose an available Shopify color scheme.
Product titleConditional
Choose a local color when the relevant custom source is enabled.
DetailsConditional
Choose a local color when the relevant custom source is enabled.
Price and badgesConditional
Choose a local color when the relevant custom source is enabled.
Badge textConditional
Choose a local color when the relevant custom source is enabled.
DividersConditional
Choose a local color when the relevant custom source is enabled.
Item card backgroundConditional
Choose a local color when the relevant custom source is enabled.
Show product and total headings
Enable or disable this option and preview the result.
Product headingConditional
Edit the text shown by this component.
Total headingConditional
Edit the text shown by this component.
Gap between items
Adjust within the range offered by the theme editor.
Show dividers between items
Enable or disable this option and preview the result.
Divider opacityConditional
Adjust within the range offered by the theme editor.
Image size
Adjust within the range offered by the theme editor.
Image corner radius
Adjust within the range offered by the theme editor.
Title size
Adjust within the range offered by the theme editor.
Title weight
Choose the presentation or source that fits this component.Options: Medium · Semi Bold · Bold · Extra Bold
Use custom title color
Enable or disable this option and preview the result.
Title colorConditional
Choose a local color when the relevant custom source is enabled.
Show vendor under title
Enable or disable this option and preview the result.
Variant text size
Adjust within the range offered by the theme editor.
Stepper corner radius
Adjust within the range offered by the theme editor.
Trash icon color
Choose a local color when the relevant custom source is enabled.
Current price size
Adjust within the range offered by the theme editor.
Compare-at price size
Adjust within the range offered by the theme editor.
Use custom color for current price
Enable or disable this option and preview the result.
Current price colorConditional
Choose a local color when the relevant custom source is enabled.
Text when price is zero
Shown instead of the price amount when an item is effectively free (e.g. a bundle free gift).
Show savings text when on sale
Enable or disable this option and preview the result.
Savings textConditional
Use [amount] to insert the savings value.
Save badge backgroundConditional
Choose a local color when the relevant custom source is enabled.
Save badge text colorConditional
Choose a local color when the relevant custom source is enabled.
Show discount tags
Enable or disable this option and preview the result.
Tag text and icon colorConditional
Choose a local color when the relevant custom source is enabled.
Show free gift badge
Enable or disable this option and preview the result.
Badge text templateConditional
Use [count] for quantity and [gift_word] for 'Gift'/'Gifts'.
Badge backgroundConditional
Choose a local color when the relevant custom source is enabled.
Badge text and icon colorConditional
Choose a local color when the relevant custom source is enabled.

Still need a hand?

Send support your store domain, theme version, error code and what you tried. Keep authentication tokens out of public messages.

Contact Scale support ↗