Introduction

Discount Kit Live automatically syncs your discount data to your Shopify storefront, making it available through metafields for instant access - no API calls, no performance overhead.

​

How It Works

When you create discounts in Discount Kit, the Refresher automatically syncs all of your active automatic discounts to your storefront. This happens completely in the background with zero configuration required. Discount data is available through metafields at three levels: products, collections, and shop-wide — all using the namespace app--9549316097--discount_kit and key discounts.

​

Collection Fan-Out

Discounts targeting collections are automatically fanned out to every product in those collections. This means a product’s metafields include all applicable discounts — both those targeting the product directly and those inherited from its collections. For example, if you create a “Summer Sale” discount on the “T-Shirts” collection, every product in that collection will have the discount in its discounts metafield. You don’t need to check the collection metafield separately — product badges just work. The same applies to max_reward_percent, max_reward_cents, and max_reward_discount — these scalar metafields reflect the best discount across both direct and collection-inherited discounts.

​

Key Features

• No API calls - Data is already on the page via metafields
• Real-time updates - Changes sync within seconds
• Zero latency - Instant access, even on collection pages with 100+ products
• Server-rendered - Available during initial page render
• Active discounts only - Expired or paused discounts are excluded
• Quick access values - Scalar metafields for the best discount (max_reward_percent, max_reward_cents)

​

Limitations and Restrictions

While Discount Kit Live provides powerful storefront access to discount data, there are some known limitations: Scalar metafields only reflect universal discounts: The max_reward_percent, max_reward_cents, and max_reward_discount scalar metafields only reflect discounts that apply to all visitors without conditions. The following discount types are excluded from scalar computation:

• Test mode discounts
• GWP (Gift With Purchase) discounts
• Customer-tagged discounts (targeting specific customer tags)
• Market-specific discounts (targeting specific markets)

These discounts still appear in the full discounts array, where you can filter them in Liquid. Use the scalar metafields for simple, drop-in badges that work for all visitors. Collection fan-out product limit: When discounts target collections, Discount Kit Live resolves every product in those collections and writes metafields to each one. This fan-out is currently limited to a maximum of 8,000 unique products across all collection-based discounts. Products beyond this limit will still receive the correct discount at checkout, but may not display badges or strike-through pricing on the storefront. This limit will be increased in a future update. Customer Segments: Shopify’s native automatic discounts support targeting by customer segments (dynamically updated customer groups based on behavior, purchase history, etc.). Unfortunately, Shopify does not currently expose customer segment information in Liquid templates. This means:

• Discounts using customer segments will work correctly at checkout
• However, Discount Kit Live cannot filter these discounts in the storefront based on segment membership
• Workaround: Use customer tags instead, which are supported in Liquid and work with Discount Kit Live

If you need to show segment-specific discounts in your storefront, consider using customer tags as an alternative targeting method.

​

Getting Started