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 surfaces up to 25 of the discounts you’ve tagged dk:live — both automatic and code-based. It doesn’t filter by who’s viewing the page, what market they’re in, or what’s already in their cart. Use these inline Liquid patterns to do that filtering in your theme.
The max_reward_percent and max_reward_cents scalar metafields automatically exclude targeted discounts (test mode, GWP, customer-tagged, market-specific, and code-based). If you use the scalar metafields for badges, no filtering is needed. The patterns below are only needed when working with the full discounts array.
Filtering by Method (Automatic vs Code)
Each discount in the discounts array carries a method field of either 'automatic' or 'code'. Split your rendering accordingly:
{% assign discounts = product.metafields.app--9549316097--discount_kit.discounts.value %}
{%- comment -%} Auto-applied discounts: render plain badges {%- endcomment -%}
{% for discount in discounts %}
{% if discount.method == 'automatic' %}
<span class="badge">{{ discount.maximum_reward_value | round }}% OFF</span>
{% endif %}
{% endfor %}
{%- comment -%} Code discounts: render code chips with copy button {%- endcomment -%}
{% for discount in discounts %}
{% if discount.method == 'code' and discount.code != blank %}
<span class="code-chip">
{{ discount.maximum_reward_value | round }}% off with <code>{{ discount.code }}</code>
</span>
{% endif %}
{% endfor %}
Hiding Codes Already Applied to the Cart
When a shopper has already entered a discount code, advertising it again is noise. Compare the code against cart.discount_applications to detect what’s in play:
{%- comment -%}
Build a lookup of applied codes once. Liquid has no Sets, so we use a
comma-joined string and `contains`. Comma wrappers prevent partial matches
(e.g. `SALE` shouldn't match `SUMMERSALE10`).
{%- endcomment -%}
{% capture applied_codes %}
{%- for application in cart.discount_applications -%}
{%- if application.type == 'discount_code' -%},{{ application.code | downcase }},{%- endif -%}
{%- endfor -%}
{% endcapture %}
{% assign discounts = product.metafields.app--9549316097--discount_kit.discounts.value %}
{% for discount in discounts %}
{% if discount.method == 'code' and discount.code != blank %}
{% assign needle = ',' | append: discount.code | downcase | append: ',' %}
{% unless applied_codes contains needle %}
<span class="code-chip">Use <code>{{ discount.code }}</code></span>
{% endunless %}
{% endif %}
{% endfor %}
Shopify normalises discount codes case-insensitively at checkout, so we downcase both sides of the comparison. The cart.discount_applications array is populated server-side on each page render, so this works without any JavaScript.
Filtering Test Mode Discounts
Discounts in test mode only apply to customers tagged test. Use the test field to exclude them from your storefront display.
{% assign discounts = product.metafields.app--9549316097--discount_kit.discounts.value %}
{% for discount in discounts %}
{% unless discount.test %}
<div class="badge">
{{ discount.maximum_reward_value | round }}% OFF
</div>
{% endunless %}
{% endfor %}
Filtering by Market
Discounts can be restricted to specific Shopify Markets. Filter to show only those applicable to the customer’s current market.
How It Works
- Uses
localization.market.handle to identify the current market
- Empty
included_markets means the discount applies to all markets
- If
included_markets has values, the current market must match
- Checks
excluded_markets to exclude specific markets
Complete Example
{% assign discounts = product.metafields.app--9549316097--discount_kit.discounts.value %}
{% assign current_market = localization.market.handle %}
{% assign eligible_discount = nil %}
{% for discount in discounts %}
{% assign is_eligible = true %}
{% comment %} Check included markets {% endcomment %}
{% if discount.included_markets.size > 0 %}
{% assign market_match = false %}
{% for market in discount.included_markets %}
{% if market == current_market %}
{% assign market_match = true %}
{% break %}
{% endif %}
{% endfor %}
{% unless market_match %}
{% assign is_eligible = false %}
{% endunless %}
{% endif %}
{% comment %} Check excluded markets {% endcomment %}
{% if discount.excluded_markets.size > 0 %}
{% for market in discount.excluded_markets %}
{% if market == current_market %}
{% assign is_eligible = false %}
{% break %}
{% endif %}
{% endfor %}
{% endif %}
{% comment %} Take first eligible discount {% endcomment %}
{% if is_eligible %}
{% assign eligible_discount = discount %}
{% break %}
{% endif %}
{% endfor %}
{% if eligible_discount %}
<div class="badge">
{{ eligible_discount.maximum_reward_value }}% OFF
</div>
{% endif %}
How It Works
- Included Tags: Customer must have at least one tag from
included_customer_tags
- Excluded Tags: Customer must not have any tag from
excluded_customer_tags
- Not Logged In: Customers who aren’t logged in are excluded from tag-targeted discounts
Complete Example
{% assign discounts = product.metafields.app--9549316097--discount_kit.discounts.value %}
{% assign eligible_discount = nil %}
{% for discount in discounts %}
{% assign is_eligible = true %}
{% comment %} Check included customer tags {% endcomment %}
{% if discount.included_customer_tags.size > 0 %}
{% if customer %}
{% assign has_required_tag = false %}
{% for required_tag in discount.included_customer_tags %}
{% if customer.tags contains required_tag %}
{% assign has_required_tag = true %}
{% break %}
{% endif %}
{% endfor %}
{% unless has_required_tag %}
{% assign is_eligible = false %}
{% endunless %}
{% else %}
{% comment %} Not logged in but tags required {% endcomment %}
{% assign is_eligible = false %}
{% endif %}
{% endif %}
{% comment %} Check excluded customer tags {% endcomment %}
{% if discount.excluded_customer_tags.size > 0 %}
{% if customer %}
{% for excluded_tag in discount.excluded_customer_tags %}
{% if customer.tags contains excluded_tag %}
{% assign is_eligible = false %}
{% break %}
{% endif %}
{% endfor %}
{% endif %}
{% endif %}
{% comment %} Take first eligible discount {% endcomment %}
{% if is_eligible %}
{% assign eligible_discount = discount %}
{% break %}
{% endif %}
{% endfor %}
{% if eligible_discount %}
<div class="vip-badge">
{{ eligible_discount.discount_title }}
</div>
{% endif %}
Combined Filtering
Combine both market and customer tag checks for complete eligibility filtering:
{% assign discounts = product.metafields.app--9549316097--discount_kit.discounts.value %}
{% assign current_market = localization.market.handle %}
{% assign eligible_discount = nil %}
{% for discount in discounts %}
{% assign is_eligible = true %}
{% comment %} Check market eligibility {% endcomment %}
{% if discount.included_markets.size > 0 %}
{% assign market_match = false %}
{% for market in discount.included_markets %}
{% if market == current_market %}
{% assign market_match = true %}
{% break %}
{% endif %}
{% endfor %}
{% unless market_match %}
{% assign is_eligible = false %}
{% endunless %}
{% endif %}
{% if discount.excluded_markets.size > 0 %}
{% for market in discount.excluded_markets %}
{% if market == current_market %}
{% assign is_eligible = false %}
{% break %}
{% endif %}
{% endfor %}
{% endif %}
{% comment %} Check customer tag eligibility {% endcomment %}
{% if is_eligible and discount.included_customer_tags.size > 0 %}
{% if customer %}
{% assign has_required_tag = false %}
{% for required_tag in discount.included_customer_tags %}
{% if customer.tags contains required_tag %}
{% assign has_required_tag = true %}
{% break %}
{% endif %}
{% endfor %}
{% unless has_required_tag %}
{% assign is_eligible = false %}
{% endunless %}
{% else %}
{% assign is_eligible = false %}
{% endif %}
{% endif %}
{% if is_eligible and discount.excluded_customer_tags.size > 0 %}
{% if customer %}
{% for excluded_tag in discount.excluded_customer_tags %}
{% if customer.tags contains excluded_tag %}
{% assign is_eligible = false %}
{% break %}
{% endif %}
{% endfor %}
{% endif %}
{% endif %}
{% if is_eligible %}
{% assign eligible_discount = discount %}
{% break %}
{% endif %}
{% endfor %}
{% if eligible_discount %}
<div class="badge">
{{ eligible_discount.maximum_reward_value }}% OFF
</div>
{% endif %}
Next Steps
