Introduction

DiscountKit Live syncs the discounts you choose to your Shopify storefront, making them available through metafields for instant access — no API calls, no performance overhead.

How it works

DiscountKit Live is opt-in. You decide which discounts the storefront sees by tagging them with dk:live in Shopify’s discount editor — the same Tags field you use for anything else. This works for both automatic discounts and discount codes (manual codes), created in DiscountKit or anywhere else in your admin.

• To include a discount in DiscountKit Live: add the tag dk:live.
• To exclude a discount: remove the tag.

Once a discount is tagged, the Refresher syncs it to your storefront within seconds. 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.

Migrating from the old behaviour?

When the tag-gated model first goes live for your shop, DiscountKit automatically applies the dk:live tag to every currently-active automatic discount, so nothing drops out of your storefront on rollout. After that one-time migration, the tag is yours to manage — add or remove it like any other tag to control what surfaces in DiscountKit Live.

Discount limits

DiscountKit Live surfaces up to 25 tagged discounts in total on each refresh. That’s a hard ceiling combining both automatic and code-based discounts, driven by Shopify’s underlying limit on the discount nodes query.

• Shopify allows at most 25 active automatic discounts on a shop, so historically the 25 cap was effectively invisible.
• With code-based discounts supported, the cap matters: if you tag 5 automatic
  • 30 code discounts with dk:live, only 25 of them will appear in DiscountKit Live on each refresh. Untag the ones you don’t need surfaced.

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

• Merchant-controlled — opt in or out per discount via the dk:live tag
• Automatic + code discounts — surface both auto-applied and code-redeemed discounts
• No API calls — data is already on the page via metafields
• Real-time updates — changes sync within seconds of tag/untag
• 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 DiscountKit 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)
• Code-based discounts (require the shopper to enter a code; advertising them in a “Save up to X%” badge would over-promise to shoppers who don’t know the code)

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, DiscountKit 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, DiscountKit 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 DiscountKit Live

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

Next steps

Read Storefront data to learn how to access discount data in your theme, then dig into Settings, the full data reference, and the guides on filtering discounts and worked examples.