Documentation/ Sections /Main cart
Contact us
Install
03GENERAL

Main cart

This page explains how “Main cart” actually behaves, which data it depends on, and what its settings change.

WHAT IT DOES

Main cart

This page explains how “Main cart” actually behaves, which data it depends on, and what its settings change.

Used in templates
cart.json
IMPLICIT BEHAVIOR

What the theme does automatically

This section only displays elements that have content. Empty elements are ignored to preserve the layout.

CONFIGURATION

Understand the settings

Cart header

Customize the cart title and information displayed for each item.

Eyebroweyebrow
Titleheading
Wording of articlesitem_count_label
Show sellershow_vendor
Default: disabled
Show customizationsshow_properties
Default: enabled

Cart columns

Customize column titles and order note display.

Productproduct_column_label
Unit priceunit_price_label
Quantityquantity_label
Totaltotal_label
View order noteshow_note
Default: enabled

Free delivery

Configure the free-shipping threshold and its progress messages. For a second-tier discount, create the rule in Shopify. For a gift, create a dedicated zero-price product and select it in the theme.

Show progressshow_free_shipping
Default: enabled
Celebrate unlocked benefits with confettienable_shipping_celebration
Default: enabled
Free delivery thresholdfree_shipping_threshold

Enter the amount to reach in the store currency.

Default: 100
Text before thresholdshipping_remaining_text
Text of threshold reachedshipping_reached_text
Show a second levelshow_reward_tier
Default: disabled
Second level thresholdreward_threshold
Default: 150
Name of the second levelreward_label
Second milestone rewardreward_type
Default: product · Options: Free product, Promotion code, Total order discount
Complimentary gift productreward_products

Used only for the free-product reward. Select a product priced at zero, or a product made free by an existing Shopify discount.

Promotion codereward_code

Used with the Promotion code reward. The apply button appears after the threshold is reached.

Reward titlereward_offer_title
Reward descriptionreward_offer_text

For an order discount, describe the automatic Shopify discount applied after the threshold. For a code reward, enter the code in the dedicated field.

Gift experience

Activate the gift option and combine the product used to add it to the cart.

Suggest gift wrappingshow_gift_wrap
Default: disabled
Gift wrapping productgift_wrap_product

This product is added to the cart when the customer chooses the gift option.

Summary

Customize the totals, notes and actions displayed before checkout.

Accessibility labelsummary_label
Abstract titlesummary_heading
Subtotalsubtotal_label
Tax informationtax_notice
Order notenote_label
Note examplenote_placeholder
Payment buttoncheckout_label
Payment informationpayment_note
Continue shoppingcontinue_label

Complementary products

Select the collection and texts used for additional recommendations.

Collectionupsell_collection
Number of productsupsell_limit
Default: 4 · Range: 0–6
Eyebrowupsell_eyebrow
Titleupsell_heading
Add buttonupsell_add_label

Empty cart

Customize the message and link offered when no item is in the cart.

Titleempty_heading
Textempty_text
Linkempty_link
Button textempty_link_label

Actions and Spacing

Adapt the action labels and vertical margins of the section.

Reduce the quantitydecrease_label
Increase the quantityincrease_label
Remove an itemremove_label
Top marginpadding_top
Default: 64 · Range: 0–120px
Bottom marginpadding_bottom
Default: 96 · Range: 0–120px

Section palette

Applies a consistent palette to the background, text, and buttons in this section.

Section appearance

Use a dedicated paletteopaline_use_color_scheme
Default: disabled
Paletteopaline_color_scheme
Default: scheme-1

Title

Alignment on desktopopaline_heading_alignment
Default: inherit · Options: Keep the design, Left, Center, Right

Spacing

Space after sectionopaline_section_spacing

Creates space between this section and the next. Mobile spacing adjusts automatically.

Default: 0 · Range: 0–160px
Left and right insetopaline_content_inset

Moves content away from the edges. Mobile spacing adjusts automatically.

Default: 0 · Range: 0–120px
COMPOSITION

Available blocks

App block@app

Add this block only when it provides useful information to the journey.

trusttrust

Add this block only when it provides useful information to the journey.

CHECKS

Before publishing

  • ✓

    Content remains readable in every color scheme.

  • ✓

    Labels match the storefront language.

  • ✓

    Displayed promotions match Shopify rules.

  • ✓

    Interactions remain accessible by keyboard and touch.