Merchant guide

MultiTier Discounts User Guide

Build tiered discounts, Buy X Get Y offers, cart value rewards, shipping benefits, and auto-added gift campaigns for Shopify stores. Use this guide to configure campaigns, test storefront behavior, and tune custom cart drawers.

Quick Start

  1. Open the app from Shopify Admin, then choose Create New Campaign.
  2. Select a campaign type that matches the offer: product, collection, quantity, price, cart value, or gift.
  3. Choose the trigger products, collections, tags, quantities, or cart thresholds.
  4. Define the discount tiers and decide whether the campaign combines with other discounts.
  5. Save as inactive first, test the storefront cart, then activate when the exact cart scenario works.
All Campaigns page with filters, settings, and create campaign actions
All Campaigns is the starting point for creating, filtering, editing, duplicating, and checking campaign status.

Campaign Builder Walkthrough

Campaign builder step 1: campaign information Campaign builder step 2: discount trigger Campaign builder step 3: discount rules Campaign builder step 4: settings
  1. Step 1 Campaign information
  2. Step 2 Discount trigger
  3. Step 3 Discount rules
  4. Step 4 Settings

Core Concepts

Trigger The condition that starts an offer, such as selected products, a collection, customer tag, quantity, price position, or cart total.
Target The product, variant, order, or shipping cost that receives the benefit after the trigger qualifies.
Tier A rule level such as "buy 2, get 10% off" or "spend $100, get a free gift".
Combination Whether the campaign can run with other product, order, and shipping discounts.

For production stores, create one focused campaign first, test it in cart and checkout, then layer more advanced targeting or priority rules.

Campaign Types

Tiered Product Discounts

Use product, collection, tag, quantity, or price based triggers to discount qualifying product lines. Product selection includes products with variants; selecting a product applies to its variants unless a legacy variant campaign already exists.

Buy X Get Y

Use this when buying one product or group unlocks a discounted or free target product. Test both the qualifying cart and the cart after the trigger item is removed.

Cart Value Rewards

Use cart subtotal thresholds to unlock product gifts, order discounts, or Starter+ shipping benefits. This is useful for "spend more, save more" campaigns.

Gift Offers

Gift offers can auto-add eligible gifts to the cart. The storefront script handles priority, manual removal, cart updates, and cleanup when the cart no longer qualifies.

Gift offer rule setup in the campaign builder
Gift rules define which products become gifts for each threshold. Use 100% for a classic free gift.

Shipping Benefits

Campaign tiers can include a shipping discount percentage on Starter and Pro plans. Use 100% for free shipping or a smaller percentage for partial shipping discounts.

  • Keep product, order, and shipping combination settings aligned with the campaign goal.
  • Test checkout delivery options because shipping discounts are visible after Shopify has delivery rates.
  • Use customer, country, schedule, and priority rules when a shipping benefit should be limited.

Shipping discounts depend on Shopify discount classes and checkout delivery options. Always test a real checkout path before publishing a shipping campaign.

Storefront Widgets

Theme app blocks can show product badges, quantity tier pickers, bundle tiers, cart progress, cross-sell cards, collection upsells, and gift auto-add behavior.

  • Enable only the widgets needed for the campaign.
  • Place product-page widgets near the product form.
  • Place cart widgets in the cart page or cart drawer area where shoppers already review totals.
  • Use the Gift Auto-Add embed when gifts should be inserted automatically.
Theme-specific media: Capture product badge, quantity tier, cart progress, and gift auto-add examples after the final storefront theme is selected.

Theme Integration

Most themes work with the default auto mode. Custom cart drawers may need selectors so the app can find the drawer, identify line items, and refresh the right section after a gift is added or removed.

Settings

  • Cart container selectors: drawer, mini-cart, or cart page wrappers, one selector per line.
  • Cart line selectors: repeated cart item rows, one selector per line.
  • Cart section IDs: Shopify section IDs used for section rendering refresh.
  • Cart refresh mode: Auto, Replace sections, or Theme events only.

How To Find Selectors

  1. Open the storefront and add a product to cart.
  2. Right-click the cart drawer or cart page and choose Inspect.
  3. Choose stable selectors such as #CartDrawer, cart-drawer, [data-cart-drawer], .cart-item, or .line-item.
  4. Avoid generated classes, animation-only classes, product titles, or selectors that disappear after the drawer opens.
Theme-specific media: Capture a short GIF showing Inspect, selector copy, Settings save, and storefront retest on the final storefront theme.

Settings & Analytics

Settings control global discount safety, gift automation, language, and theme integration fields. Analytics summarizes processed order usage after campaigns start receiving orders.

Settings page with discount safety, gift automation, theme integration, and language sections
Use Settings to keep global behavior predictable before adding theme-specific selector overrides.
Analytics dashboard with usage totals and campaign performance
Analytics shows campaign usage, discount impact, affected orders, and campaign performance after orders are processed.

Storefront Testing Checklist

  • Campaign is active and scheduled for the correct date.
  • Exact trigger cart qualifies.
  • Non-qualifying cart does not receive the benefit.
  • Gift is removed when the trigger is removed.
  • Manual gift removal is respected when configured.
  • Discount label appears correctly in checkout.
  • Mobile cart drawer refreshes correctly.
  • Cart page and cart drawer behave consistently.
  • Country and customer tag targeting work when enabled.
  • Combination rules match the merchant promise.

Troubleshooting

Gift does not auto-add

Confirm the Gift Auto-Add embed is enabled, the campaign is active, the cart qualifies, and theme selectors point to real cart elements.

Cart drawer does not refresh

Set Cart refresh mode to Replace sections and add the drawer section ID. If the theme handles its own refresh events, try Theme events only.

Discount appears in cart but not checkout

Check campaign dates, discount classes, combination rules, target products, customer tags, and country targeting.

Need debug logs

Add ?mtdGiftDebug=1 to the storefront URL to enable Gift Auto-Add console logs. Use ?mtdGiftDebug=0 to disable them.

Media Checklist

Admin screenshots are included above. Use the remaining slots when preparing public documentation, GitBook pages, or a theme-specific storefront guide.

  • All Campaigns overview screenshot. Included.
  • Create campaign flow walkthrough. Included as an animated browser slideshow.
  • Settings page screenshot. Included.
  • Analytics dashboard screenshot. Included.
  • Product picker with variants screenshot.
  • Shipping discount tier screenshot.
  • Gift auto-add storefront GIF.
  • Theme selector setup GIF.
  • Checkout discount verification screenshot.
Privacy Policy Terms of Service Support