Introduction

Documentation Index

Fetch the complete documentation index at: https://discountkit.app/llms.txt

Use this file to discover all available pages before exploring further.

Discount Kit 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

Discount Kit 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 Discount Kit or anywhere else in your admin.

• To include a discount in Discount Kit 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.

​

Discount Limits

Discount Kit 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 before this PR the 25 cap was effectively invisible.
• With code-based discounts now supported, the cap matters: if you tag 5 automatic + 30 code discounts with dk:live, only 25 of them will appear in Discount Kit 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 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)
• 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, 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