Shopify Product Availability Structured Data

The schema.org ItemAvailability Enum

schema.org defines nine ItemAvailability values. Shopify's default JSON-LD only uses two. Understanding all nine helps you represent complex inventory situations accurately:

Shopify Liquid: Dynamic Availability Mapping

Shopify exposes several inventory properties in Liquid. The correct approach is to derive the schema.org availability value dynamically from these properties — never hardcode "InStock".

Basic availability mapping

{%- assign availability = 'https://schema.org/OutOfStock' -%}
{%- if product.available -%}
  {%- assign availability = 'https://schema.org/InStock' -%}
{%- endif -%}

"availability": {{ availability | json }}

Extended mapping with PreOrder and LimitedAvailability

{%- assign availability = 'https://schema.org/OutOfStock' -%}
{%- assign first_variant = product.selected_or_first_available_variant -%}

{%- if first_variant.available -%}
  {%- if first_variant.inventory_management == 'shopify' and first_variant.inventory_quantity <= 5 -%}
    {%- assign availability = 'https://schema.org/LimitedAvailability' -%}
  {%- else -%}
    {%- assign availability = 'https://schema.org/InStock' -%}
  {%- endif -%}
{%- elsif first_variant.inventory_policy == 'continue' -%}
  {%- comment -%}
    'continue' = "Continue selling when out of stock" — BackOrder pattern
  {%- endcomment -%}
  {%- assign availability = 'https://schema.org/BackOrder' -%}
{%- endif -%}

"availability": {{ availability | json }}

The inventory_policy == 'continue' case maps to BackOrder semantics — the product will be manufactured or restocked and ships after a delay. This is more accurate than OutOfStock for products where "Continue selling" is intentional.

PreOrder pattern

{%- comment -%}
  Set a metafield: product.metafields.custom.preorder_ship_date = "2026-09-01"
  when a product is in pre-order status
{%- endcomment -%}
{%- assign preorder_date = product.metafields.custom.preorder_ship_date -%}
{%- if preorder_date != blank -%}
  "availability": "https://schema.org/PreOrder",
  "availabilityStarts": {{ preorder_date | json }}
{%- else -%}
  "availability": {{ availability | json }}
{%- endif -%}

Variant-Level Availability in Offers

The single most impactful availability improvement for Shopify stores with multiple variants is adding per-variant Offer blocks. Shopify's default JSON-LD generates one Offer for the cheapest available variant — which means out-of-stock variants are invisible to agents, and agents can't recommend in-stock variants of an otherwise "mixed" product.

Per-variant Offer with availability

"offers": [
  {%- for variant in product.variants -%}
  {
    "@type": "Offer",
    "name": {{ variant.title | json }},
    "sku": {{ variant.sku | json }},
    "price": {{ variant.price | money_without_currency | json }},
    "priceCurrency": {{ cart.currency.iso_code | json }},
    "url": "{{ shop.url }}/products/{{ product.handle }}?variant={{ variant.id }}",
    "priceValidUntil": "{{ 'now' | date: '%s' | plus: 2592000 | date: '%Y-%m-%d' }}",
    "availability": "{% if variant.available %}https://schema.org/InStock{% else %}https://schema.org/OutOfStock{% endif %}"
  }{% unless forloop.last %},{% endunless %}
  {%- endfor -%}
]

With this pattern, a product with 8 color variants where 2 are sold out exposes 6 InStock Offers and 2 OutOfStock Offers. AI agents recommending "navy blue version" will find the InStock navy variant and link directly to it via the ?variant=ID URL.

Availability Freshness and priceValidUntil

AI agents assign a freshness score to structured data based on how recently the page was crawled and whether time-sensitive fields like priceValidUntil are current. The relationship between availability and freshness:

IndexNow on availability change (Node.js webhook example)

// Shopify webhook: inventory_levels/update
app.post('/webhooks/inventory', async (req, res) => {
  const { inventory_item_id, available } = req.body;
  const product = await getProductByInventoryItem(inventory_item_id);

  // Ping IndexNow when availability crosses a threshold
  if (available === 0 || available === 1) {
    await fetch('https://api.indexnow.org/indexnow', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        host: 'yourstore.com',
        key: process.env.INDEXNOW_KEY,
        urlList: [`https://yourstore.com/products/${product.handle}`]
      })
    });
  }
  res.sendStatus(200);
});

Availability Structured Data Checklist

Related Resources

• Ecommerce Out-of-Stock SEO and Structured Data — strategies for maintaining SEO value while products are out of stock.
• Shopify Schema Markup Guide — full JSON-LD implementation reference including Offer, availability, and priceValidUntil.
• Shopify AI Agent Checkout Optimization — how availability accuracy reduces cart abandonment from AI-referred traffic.
• AI Shopping Agent Product Ranking Factors — where availability ranks among the full 18 catalog signals.

Frequently Asked Questions

Audit Availability Accuracy Across Your Catalog

CatalogScan scans your store for hardcoded availability values, missing variant-level Offer blocks, expired priceValidUntil dates, and BackOrder products lacking availabilityStarts — then ranks each issue by its impact on AI shopping agent recommendation eligibility.