Maximize Theme User Guide

Search limit to:






Cart
Ask AI

1. What setup can you do in Cart?

  • Use case 1: Enable quick-view cart functionality with essential features like cart icons, notes, and payment displays.
  • Use case 2: Add custom fields, shipping estimates, and upsell recommendations to enhance user experience and boost conversions.
  • Use case 3: Control whether the cart drawer opens automatically when a product is added, or redirect customers to the full Cart page instead.

2. Location & Setup

  1. Go to "Online Store" > "Themes" > "Customize".
  2. Click the Theme Settings tab.
  3. Go to Cart.

3. Setting group overview

Group name Purpose
Cart (General settings) Configure basic cart functionality and appearance, including minicart
Cart drawer Control whether the cart drawer opens when a product is added to cart, and manage its related settings (View cart button, Continue shopping link).
Cart features Configure cart display options: product image ratio, vendor name, cart note, payment icons, discount code field, and savings amount.
Cart terms Set up a terms and conditions checkbox customers must agree to before proceeding to checkout.
Cart custom field Add custom input fields to collect additional order information from customers.
Cart upsell Display personalized product recommendations to increase order value.
Catalog mode Turn off all cart-related functionality to display your store as a catalog only.

4. Common Use Cases

🤔 How to set up a basic Cart?

Want to enable a quick-view shopping cart that slides out when customers add items to cart? Here's how:

STEP 1:

Go to Theme Settings > Cart.

STEP 2: Configure cart icon & display

  • Cart icon: Choose between Shopping cart or Bag icon in the header.
  • Image ratio: Set product image aspect ratio in the mini cart (e.g., Natural, Square (1:1), Landscape (4:3), Portrait (2:3), Wide (16:9), Standard (3:4)).
  • Toggle Show vendor to display product brand names.

STEP 3: Enable key features

  • Enable cart note: Allow customers to add special instructions (e.g., gift messages).
  • Enable "View cart" button: Redirects users to the full cart page.
  • Enable payment icons: Display trusted payment logos (e.g., Apple Pay).
  • Custom payment icons SVG: Add specific payment methods (e.g., apple_pay, google_pay).

STEP 4: Set up cart behavior

  • Continue shopping link: Customize the text link to the "Continue shopping" button.
  • Enable discount code field: Let customers apply promo codes in the mini cart.
  • Show savings amount: Display discount totals to highlight value.
  • Enable terms and conditions: Add a checkbox for legal compliance and choose the Terms and conditions page.

STEP 5:

Click "Save" when done.

🤔 How to add a cart custom field to the cart?

Want to collect additional information from customers (like gift messages or special instructions) directly in the mini cart? Here's how:

STEP 1: Navigate to the settings panel

Go to Theme Settings > Cart > Cart custom field.

STEP 2: Activate the feature

Toggle Enable Custom field to activate the feature.

STEP 3: Configure field settings

  • Field label: Enter a clear title (e.g., "Gift message," "Special instructions"). Required to enable the field.
  • Mark custom field as required: Toggle if customers must fill it out before checkout.
  • Validation regex (Advanced): Use regex patterns for specific input rules (e.g., email format). Leave blank if unsure.

STEP 4: Click "Save" when done.

🤔 How to display the estimated shipping cost in the cart?

Please check out this guide for detailed guidance.

🤔 How to show a Free shipping bar on the cart?

Want to motivate customers to add more items by showing a free shipping progress bar? Here's how:

Prerequisite: Before using the Free shipping bar, set up a free shipping rule in your Shopify admin. Refer to the Shopify documentation for detailed instructions.

STEP 1:

Go to Theme Settings > Shipping and Delivery > Free shipping.

STEP 2:

Toggle Enable to activate the feature.

Under Order amount for free_shipping, enter the minimum order amount. Supported formats:

Format Example When it applies
Amount 100 All countries and currencies.
Currency code:Amount USD:100 Any country using USD.
Country code:Currency code:Amount US:USD:100 United States with USD only.

⚠️ Note: Add one rule per line only.

STEP 3:

Click "Save" when done.

STEP 4: Check the storefront display in Mini cart:

  • Case 1: When the cart doesn't meet the free shipping threshold, the bar prompts customers to add more items.

  • Case 2: When the cart qualifies for free shipping, the bar communicates the achievement.

🤔 How to configure Cart upsell at Mini cart?

🔍 Information: Cart Upsell is a sales strategy that promotes additional, complementary, or higher-value products to customers after they've added an item to their cart. It's designed to increase average order value (AOV), introduce customers to relevant products they might have missed, and enhance the shopping experience with personalized recommendations.

Want to show personalized product recommendations in the mini cart to increase average order value? Here's how:

STEP 1:

Go to Theme Settings > Cart > Cart upsell.

STEP 2:

Toggle Enable in minicart to activate the feature.

STEP 3: Configure upsell priority settings

Cart upsell recommendations are displayed based on this priority:

1. Product metafield (highest priority)

For more advanced customization, enabling you to tailor the Cart Upsell section for each product, you can utilize metafields. Follow the guide below to add metafields:

  • Create a Metafield: Navigate to your store and go to Settings > Metafields and metaobjects > choose Products.

Click "Add definition" to create a metafield for the product.

  • Fill in the following information:
    • Name: Provide a name for the metafield. We recommend using "Cart Upsell" to avoid confusion.
    • Namespace and Key: The key must be "cart.upsell" for the metafield to work.
    • Description: Optional.
    • Select Type: Choose "Product" then select "List of Products".

  • After setting up the metafield, go to each product page in the Shopify Admin. Scroll down to Metafield > Cart Upsell and select the upsell products.

⚠️ Note: If products B, C, and D are set as upsell products for product A, they appear in the Cart Upsell section whenever A is added to cart. Metafield takes priority over other methods.

2. Manual selection

  • In the Product field, manually select upsell products.

⚠️ Note: Leave this field blank if you are using product metafields.

3. Dynamic recommendations (lowest priority)

  • Uses Shopify's auto-generated suggestions if no metafield or manual list is set. Based on purchase history and product descriptions.

⚠️ Note: See the Shopify guide for more information.

STEP 4:

  • Set Number of products shown (1–20). We recommend 3–6 for optimal visibility.
  • Change Section label to customize the upsell heading (e.g., "Complete your kit!").
  • Toggle Share cart link on to let customers share their cart - useful for gift purchases or team approvals.

STEP 5:

Click "Save" when done.

🤔 How to hide the cart?

Why you might want to hide the cart:

  • For businesses selling wholesale or B2B, it may be preferable to have customers contact sales representatives directly rather than using an online cart.
  • Some stores display products purely for informational purposes without enabling direct purchase.
  • When preparing for a launch or running a preview, the cart can be hidden while the product catalog is displayed.

To hide the cart:

In Theme settings > Cart > Catalog mode > Toggle Hide cart ON.

When Hide cart is enabled:

  • Cart icon will not be displayed in the Header.
  • Quick add options will be hidden.
  • Add-to-cart button will not be shown on product pages, featured products, or quick view.

🤔 How to disable the cart drawer when a product is added?

By default, the cart drawer slides open every time a customer adds a product. If you prefer customers to navigate to the full Cart page instead, you can disable this behavior.

STEP 1:

Go to Theme Settings > Cart > Cart drawer.

STEP 2: Find and adjust the Enable cart drawer toggle.

Setting Behavior
Enable cart drawer = ON (default)
  • The cart drawer opens automatically each time a product is added.
  • The add-to-cart button/icon briefly shows a checkmark, then returns to its original state after 2 seconds.
  • If the maximum quantity is exceeded, an error message is shown and the cart drawer does not open.

Enable cart drawer = OFF
  • The cart drawer does not open when products are added.
  • The add-to-cart button/icon still shows a checkmark for 2 seconds as confirmation.
  • The cart icon in the header updates its quantity count.
  • Clicking the cart icon navigates the customer to the full Cart page instead of opening the drawer.

STEP 3:

Click "Save" when done.

🤔 How does discount code removal work in the cart?

Applied discount codes now appear as individual removable chips in the cart's discount section - in both the cart drawer and the Cart page. No additional setup is needed; this works automatically when Enable discount code field is turned on.

What it looks like: Each applied code appears as a labeled chip (e.g., SUMMER20 ×). Code names longer than 20 characters are truncated with "…".

How to remove a discount code: Click the × button on the chip. The code is removed and the order total is recalculated automatically.

⚠️ Notes:

  • Only manually applied discount codes (entered by the customer) show the × button. Automatically applied discounts do not.
  • Only one code can be removed at a time. A loading indicator appears on the chip while removal is being processed.
  • If removal fails, the following error appears below the chips: "An error occurred, please refresh the page and try again."
  • Removals are synchronized between the cart drawer and the Cart page.

5. Change logs

Version 1.7.0 - May 2026

  • Updated: Cart settings reorganized into three new groups - Cart drawer, Cart features, and Cart terms - for cleaner navigation in the Theme Editor.
  • New - Enable cart drawer: A new toggle under Cart drawer lets merchants disable the cart drawer from opening when a product is added. When disabled, the cart icon updates its count and clicking it navigates to the full Cart page instead.
  • New - Discount code removal: Applied discount codes now appear as individual removable chips in both the cart drawer and Cart page. Customers can click × on any chip to remove that code. Supports all manually applied discount types.

6. Support Information

Need help? Contact our support team at Omni Themes Support