Ecommerce Pre-Order and Deposit Payment Structured Data for AI Shopping Agents

The Pre-Order Visibility Problem

Shopify's inventory system treats products with zero stock and "continue selling" enabled as effectively out-of-stock in structured data terms — because that's what the inventory quantity signals. The product JSON-LD generated by Shopify defaults to OutOfStock when inventory is zero, regardless of whether you've configured a pre-order tag, a pre-order app, or a product description that explicitly says "Pre-order now — ships August 15."

The consequence for AI shopping agents is that your pre-order product competes in the same "unavailable" bucket as discontinued items and stock-outs. When a user asks "can I pre-order the new standing desk from X brand?", the AI agent has no machine-readable signal to distinguish your pre-order from a product that's simply sold out.

Availability states and AI agent behavior

Pre-Order JSON-LD Patterns

Minimum viable pre-order markup

The single most impactful change is setting Offer.availability to PreOrder and adding a releaseDate property. AI agents can surface "pre-order available" and estimate delivery context from these two signals alone:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Adjustable Standing Desk Pro — Walnut",
  "description": "Motorized standing desk with walnut desktop. Pre-order now for August 2026 delivery.",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "releaseDate",
      "name": "Expected ship date",
      "value": "2026-08-15"
    }
  ],
  "offers": {
    "@type": "Offer",
    "price": "649.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/PreOrder",
    "url": "https://example.com/products/standing-desk-walnut"
  }
}

Pre-order with deposit payment structure

For products requiring a deposit at order time with the balance due at shipping, use priceSpecification to declare both the deposit and the full price. The Offer.price must always reflect the total product price — not just the deposit:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Limited Edition Handmade Sofa — Forest Green",
  "description": "Hand-stitched linen sofa. 12-week production. $250 deposit reserves your order; balance charged at shipping.",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "releaseDate",
      "name": "Expected ship date",
      "value": "2026-09-01"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "depositAmount",
      "name": "Pre-order deposit",
      "value": "250.00",
      "unitCode": "USD"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "remainingBalanceDue",
      "name": "Balance due at shipping",
      "value": "1150.00",
      "unitCode": "USD"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "productionLeadTime",
      "name": "Production lead time",
      "value": "12 weeks"
    }
  ],
  "offers": {
    "@type": "Offer",
    "price": "1400.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/PreOrder",
    "priceSpecification": [
      {
        "@type": "PriceSpecification",
        "price": "250.00",
        "priceCurrency": "USD",
        "name": "Pre-order deposit (due now)"
      },
      {
        "@type": "PriceSpecification",
        "price": "1150.00",
        "priceCurrency": "USD",
        "name": "Balance due at shipping"
      }
    ]
  }
}

Pre-order with future open date

When pre-orders haven't opened yet (announcement phase), use availabilityStarts on the Offer to tell AI agents when ordering becomes possible:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Wireless Noise-Cancelling Headphones X2",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "releaseDate",
      "name": "Expected ship date",
      "value": "2026-10-01"
    }
  ],
  "offers": {
    "@type": "Offer",
    "price": "299.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/PreOrder",
    "availabilityStarts": "2026-07-15T00:00:00Z",
    "availabilityEnds": "2026-09-30T23:59:59Z"
  }
}

Shopify Liquid Implementation

Shopify's default JSON-LD uses inventory quantity to determine availability. For pre-orders, you need to override this logic using a metafield that explicitly flags the product as a pre-order. This prevents the zero-inventory fallback to OutOfStock.

Recommended metafield structure

Liquid snippet for product JSON-LD

{% assign po = product.metafields.preorder %}
{% assign is_preorder = po.is_preorder %}
{% assign full_price = product.price | money_without_currency | remove: ',' %}

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": {{ product.title | json }},
  "description": {{ product.description | strip_html | truncate: 500 | json }},
  {% if is_preorder and po.ship_date != blank %}
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "releaseDate",
      "name": "Expected ship date",
      "value": {{ po.ship_date | date: '%Y-%m-%d' | json }}
    }
    {% if po.deposit_amount != blank %}
    ,{
      "@type": "PropertyValue",
      "propertyID": "depositAmount",
      "name": "Pre-order deposit",
      "value": {{ po.deposit_amount | json }},
      "unitCode": {{ cart.currency.iso_code | json }}
    }
    ,{
      "@type": "PropertyValue",
      "propertyID": "remainingBalanceDue",
      "name": "Balance due at shipping",
      "value": {{ product.price | minus: po.deposit_amount | money_without_currency | remove: ',' | json }},
      "unitCode": {{ cart.currency.iso_code | json }}
    }
    {% endif %}
  ],
  {% endif %}
  "offers": {
    "@type": "Offer",
    "price": {{ full_price | json }},
    "priceCurrency": {{ cart.currency.iso_code | json }},
    "availability": {% if is_preorder %}"https://schema.org/PreOrder"{% elsif product.available %}"https://schema.org/InStock"{% else %}"https://schema.org/OutOfStock"{% endif %}
    {% if is_preorder and po.availability_starts != blank %}
    ,"availabilityStarts": {{ po.availability_starts | date: '%Y-%m-%dT%H:%M:%SZ' | json }}
    {% endif %}
    {% if is_preorder and po.deposit_amount != blank %}
    ,"priceSpecification": [
      {
        "@type": "PriceSpecification",
        "price": {{ po.deposit_amount | json }},
        "priceCurrency": {{ cart.currency.iso_code | json }},
        "name": "Pre-order deposit (due now)"
      },
      {
        "@type": "PriceSpecification",
        "price": {{ product.price | minus: po.deposit_amount | money_without_currency | remove: ',' | json }},
        "priceCurrency": {{ cart.currency.iso_code | json }},
        "name": "Balance due at shipping"
      }
    ]
    {% endif %}
  }
}

Automating the PreOrder → InStock transition

The most common pre-order structured data error is forgetting to flip availability from PreOrder to InStock when fulfillment begins. Options for automation:

• Shopify Flow: Trigger on inventory quantity threshold — when inventory_quantity > 0 and preorder.is_preorder = true, set preorder.is_preorder = false
• Ship date check in Liquid: Compare po.ship_date to 'now' | date: '%Y-%m-%d'; if ship date is past, fall back to inventory-based availability
• Shopify Bulk Operations + metafield mutation: Run a nightly script that sets preorder.is_preorder = false for all products whose ship date has passed

Pre-Order Availability Transition Timeline

Common Mistakes and How to Avoid Them

Implementation Checklist

• Set Offer.availability = https://schema.org/PreOrder for all pre-order products
• Add releaseDate additionalProperty with ISO 8601 date (YYYY-MM-DD)
• Use full product price in Offer.price — never the deposit amount alone
• Declare deposit and balance in priceSpecification if deposit-based pre-order
• Add availabilityStarts if pre-orders open on a specific future date
• Create preorder.is_preorder boolean metafield to toggle JSON-LD availability
• Automate PreOrder → InStock transition when fulfillment begins
• Ping IndexNow on status changes (pre-order opens, closes, ships)
• Test Rich Results Test after setting PreOrder to confirm structured data validates
• Run CatalogScan to verify pre-order availability appears in AI readiness score

Related Resources

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