Ecommerce Bundle Discount Schema for AI Shopping Agents

Why Bundle Discounts Are Invisible to AI Agents

Shopify's discount system works entirely at checkout time. When a customer qualifies for "Buy 2 Get 10% Off", the discount applies in the cart on a checkout.shopify.com URL that AI agents cannot crawl. From an AI agent's perspective, your product has exactly one price: whatever appears in your product page JSON-LD.

The implication: if you run any bundle deals that aren't reflected in JSON-LD, competing stores with cleaner markup will appear to offer better per-unit pricing — even if your effective price is lower. AI agents recommend based on what they can confirm, not what they have to guess.

Core Pattern: Dual Offer Blocks with eligibleQuantity

The schema.org standard for quantity-conditional pricing is the eligibleQuantity property on an Offer. Publish one Offer per pricing tier, each with its own quantity constraint using QuantitativeValue.

Buy 2, save 10% — full example

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Daily Vitamin C Serum 30ml",
  "offers": [
    {
      "@type": "Offer",
      "name": "Single bottle",
      "price": "38.00",
      "priceCurrency": "USD",
      "availability": "https://schema.org/InStock",
      "eligibleQuantity": {
        "@type": "QuantitativeValue",
        "minValue": 1,
        "maxValue": 1,
        "unitCode": "C62"
      }
    },
    {
      "@type": "Offer",
      "name": "2-pack — save 10%",
      "price": "34.20",
      "highPrice": "38.00",
      "priceCurrency": "USD",
      "availability": "https://schema.org/InStock",
      "eligibleQuantity": {
        "@type": "QuantitativeValue",
        "minValue": 2,
        "unitCode": "C62"
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "propertyID": "promotionType",
          "name": "Promotion Type",
          "value": "MultiBuyDiscount"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "discountPercent",
          "name": "Discount",
          "value": "10%"
        }
      ]
    }
  ]
}

Three-tier bundle (1 / 3 / 6)

"offers": [
  {
    "@type": "Offer", "name": "Single unit",
    "price": "24.00", "priceCurrency": "USD",
    "eligibleQuantity": { "@type": "QuantitativeValue", "minValue": 1, "maxValue": 2, "unitCode": "C62" }
  },
  {
    "@type": "Offer", "name": "3-pack — save 15%",
    "price": "20.40", "highPrice": "24.00", "priceCurrency": "USD",
    "eligibleQuantity": { "@type": "QuantitativeValue", "minValue": 3, "maxValue": 5, "unitCode": "C62" },
    "additionalProperty": { "@type": "PropertyValue", "propertyID": "discountPercent", "value": "15%" }
  },
  {
    "@type": "Offer", "name": "6-pack — save 25%",
    "price": "18.00", "highPrice": "24.00", "priceCurrency": "USD",
    "eligibleQuantity": { "@type": "QuantitativeValue", "minValue": 6, "unitCode": "C62" },
    "additionalProperty": { "@type": "PropertyValue", "propertyID": "discountPercent", "value": "25%" }
  }
]

BOGO Schema Pattern

Buy One Get One deals have an effective per-unit price of half the single-unit price for BOGO Free, or proportionally less for BOGO discounts. Encode this with maxValue: 2 and the correct effective price:

{
  "@type": "Offer",
  "name": "BOGO Free — buy 2, pay for 1",
  "price": "22.50",
  "highPrice": "45.00",
  "priceCurrency": "USD",
  "eligibleQuantity": {
    "@type": "QuantitativeValue",
    "minValue": 2,
    "maxValue": 2,
    "unitCode": "C62"
  },
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "promotionType",
      "value": "BOGO"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "promotionDescription",
      "value": "Buy one, get one free — add two to cart to apply"
    }
  ]
}

Shopify Liquid Implementation

Store bundle pricing in a product metafield namespace (bundle.discount_pct, bundle.min_qty) and read it in your Liquid template. This approach lets marketing update discounts through Shopify Admin without touching theme code:

{% comment %} In product.liquid, inside the offers array {% endcomment %}
{% if product.metafields.bundle.discount_pct %}
  {% assign bundle_qty = product.metafields.bundle.min_qty | default: 2 %}
  {% assign discount = product.metafields.bundle.discount_pct | times: 1.0 %}
  {% assign bundle_price = product.price | times: 1.0 | divided_by: 100 %}
  {% assign bundle_price = bundle_price | times: 100 | minus: discount | divided_by: 100 %}
  ,{
    "@type": "Offer",
    "name": {{ bundle_qty | append: "-pack bundle — save " | append: product.metafields.bundle.discount_pct | append: "%" | json }},
    "price": {{ bundle_price | money_without_currency | json }},
    "highPrice": {{ product.price | money_without_currency | json }},
    "priceCurrency": {{ cart.currency.iso_code | json }},
    "availability": "https://schema.org/InStock",
    "eligibleQuantity": {
      "@type": "QuantitativeValue",
      "minValue": {{ bundle_qty }},
      "unitCode": "C62"
    },
    "additionalProperty": {
      "@type": "PropertyValue",
      "propertyID": "discountPercent",
      "value": {{ product.metafields.bundle.discount_pct | append: "%" | json }}
    }
  }
{% endif %}

Setting bundle metafields in Shopify Admin

Define two metafields in your Shopify Admin → Settings → Custom data → Products:

Bundle Discount Description Supplement

Add bundle pricing explicitly to your product description for NLP fallback coverage. AI agents parse description text when structured data is missing or ambiguous:

promotionType Values for AI Agent Classification

Using consistent promotionType values in your additionalProperty helps AI agents classify and filter promotions accurately:

Bundle Discount Schema Checklist

1. Store bundle discount parameters in product metafields (bundle.discount_pct, bundle.min_qty) rather than hard-coding values
2. Add a second Offer block to your product JSON-LD with eligibleQuantity.minValue equal to the bundle threshold
3. Set price in the bundle Offer to the effective per-unit discounted price (not the total bundle price)
4. Set highPrice to the full unit price so AI agents can calculate the savings percentage
5. Add additionalProperty with promotionType and discountPercent for explicit classification
6. Add bundle pricing language to your product description for NLP fallback coverage
7. For time-limited bundle deals, add priceValidUntil with an ISO 8601 date string
8. Validate the updated JSON-LD using Google's Rich Results Test to catch syntax errors
9. Ping IndexNow with updated product URLs after publishing bundle markup

Related Resources

• Shopify Product Bundle Structured Data — JSON-LD patterns for gift sets and product bundles using ItemList.
• Shopify Subscription Pricing Structured Data — UnitPriceSpecification for recurring billing models.
• Shopify Schema Markup Guide — full Product, Offer, and additionalProperty implementation guide.
• AI Shopping Agent Product Ranking Factors — the full 18-signal model where pricing clarity fits in.

Frequently Asked Questions

Check Your Bundle Pricing Visibility

CatalogScan scans your product catalog for missing bundle pricing signals, malformed eligibleQuantity blocks, and promotion markup gaps — then ranks them by impact on AI agent citation rates for deal-intent queries.