Shopify Low Stock and Scarcity Signal Structured Data for AI Shopping Agents

The Scarcity Visibility Gap

Inventory urgency is one of the most powerful conversion levers in e-commerce. "Only 3 left" banners, low-stock warnings, and "limited edition" badges are standard on product pages — but they are JavaScript-rendered or text-based, neither of which is machine-readable by AI shopping agents crawling your structured data.

Shopify generates "availability": "https://schema.org/InStock" for any in-stock product, regardless of quantity. A product with 500 units and a product with 2 units left look identical to every AI shopping index. This means your genuine scarcity signals — the exact situations where urgency should drive recommendation priority — are completely absent from the AI shopping layer.

Scarcity query types that require LimitedAvailability signals

InStock vs. LimitedAvailability — what AI agents see

{
  "@type": "Offer",
  "price": "149.00",
  "availability":
    "https://schema.org/
    InStock"
  // Same signal whether
  // 500 units or 2 units
  // No urgency for AI agent
}

{
  "@type": "Offer",
  "price": "149.00",
  "availability":
    "https://schema.org/
    LimitedAvailability",
  "additionalProperty": [{
    "propertyID":
      "limitedEdition",
    "value": "true"
  }],
  "inventoryLevel": {
    "value": 3
  }
}

Scarcity JSON-LD Patterns

Dynamic low-stock — inventory-threshold based

The most important pattern: use LimitedAvailability when inventory is below threshold, driven dynamically by Liquid. This keeps your structured data synchronized with real stock levels:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Vintage Analog Watch — Navy Blue",
  "offers": {
    "@type": "Offer",
    "price": "189.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/LimitedAvailability",
    "inventoryLevel": {
      "@type": "QuantitativeValue",
      "value": 4
    }
  }
}

True limited edition — finite production run

For genuinely limited products (numbered prints, special colorways, one-time production batches), declare both the limited edition status and the total production count:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Artist Print — 'Morning Light' — Limited Edition",
  "offers": {
    "@type": "Offer",
    "price": "450.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/LimitedAvailability",
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "propertyID": "limitedEdition",
        "name": "Limited edition",
        "value": "true"
      },
      {
        "@type": "PropertyValue",
        "propertyID": "productionRun",
        "name": "Total production run",
        "value": "250"
      },
      {
        "@type": "PropertyValue",
        "propertyID": "editionNumber",
        "name": "This print",
        "value": "Individually numbered 1–250"
      }
    ],
    "inventoryLevel": {
      "@type": "QuantitativeValue",
      "value": 47,
      "description": "47 of 250 remaining"
    }
  }
}

Time-limited drop with availability end date

For flash drops or seasonal collections with a hard end date, use availabilityEnds to signal to AI agents that the product has a time deadline:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Holiday Gift Set — Collector's Edition",
  "offers": {
    "@type": "Offer",
    "price": "89.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/LimitedAvailability",
    "availabilityEnds": "2026-12-24T23:59:59-05:00",
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "propertyID": "limitedEdition",
        "value": "true"
      },
      {
        "@type": "PropertyValue",
        "propertyID": "dropType",
        "value": "Holiday seasonal — no restock after December 24"
      }
    ]
  }
}

Availability state progression

Manage the Offer.availability value as a lifecycle. The correct progression as inventory changes:

Shopify Liquid Implementation

The key is driving availability dynamically from variant.inventory_quantity. This keeps structured data synchronized with actual stock levels without manual updates:

{% assign variant = product.selected_or_first_available_variant %}
{% assign qty = variant.inventory_quantity %}
{% assign is_limited_edition = product.metafields.scarcity.limited_edition %}
{% assign production_run = product.metafields.scarcity.production_run %}
{% assign availability_ends = product.metafields.scarcity.availability_ends %}
{% assign low_stock_threshold = 10 %}

{% if product.available %}
  {% if qty <= low_stock_threshold %}
    {% assign availability = 'LimitedAvailability' %}
  {% else %}
    {% assign availability = 'InStock' %}
  {% endif %}
{% elsif variant.available == false and product.available %}
  {% assign availability = 'BackOrder' %}
{% else %}
  {% assign availability = 'OutOfStock' %}
{% endif %}

"offers": {
  "@type": "Offer",
  "price": {{ variant.price | money_without_currency | remove: ',' | json }},
  "priceCurrency": {{ cart.currency.iso_code | json }},
  "availability": "https://schema.org/{{ availability }}"
  {% if availability_ends %}
  ,"availabilityEnds": {{ availability_ends | json }}
  {% endif %}
  {% if qty > 0 and qty <= 20 %}
  ,"inventoryLevel": {
    "@type": "QuantitativeValue",
    "value": {{ qty }}
  }
  {% endif %}
  {% if is_limited_edition or production_run %}
  ,"additionalProperty": [
    {% if is_limited_edition %}
    {
      "@type": "PropertyValue",
      "propertyID": "limitedEdition",
      "value": "true"
    }
    {% if production_run %},{% endif %}
    {% endif %}
    {% if production_run %}
    {
      "@type": "PropertyValue",
      "propertyID": "productionRun",
      "name": "Total production run",
      "value": {{ production_run | json }}
    }
    {% endif %}
  ]
  {% endif %}
}

Set up these metafields in Shopify Admin → Settings → Custom data → Products for the scarcity namespace:

Common Mistakes

Implementation Checklist

• Update product.liquid JSON-LD to drive Offer.availability dynamically from variant.inventory_quantity
• Set LimitedAvailability when inventory_quantity is below your low-stock threshold (default: 10 units)
• Create scarcity metafield namespace: limited_edition, production_run, availability_ends
• Add limitedEdition: true additionalProperty for products that will never be restocked
• Add productionRun additionalProperty for numbered or finite-edition products
• Add availabilityEnds for all time-limited drops and seasonal collections
• Only output inventoryLevel when quantity is above 2 (to avoid exposing critically low counts to competitors)
• Revert to InStock automatically when inventory exceeds threshold after restock
• Validate with Rich Results Test after updating availability logic
• Run CatalogScan to verify scarcity signals appear correctly in your AI readiness score

Related Resources

• Shopify Product Availability Structured Data
• Flash Sale Structured Data for Shopify
• Out-of-Stock SEO and Structured Data Guide