Shopify Product Expiry and Best-Before Date Structured Data for AI Shopping Agents

The Freshness Visibility Gap

Freshness and shelf life are critical purchase-decision signals for food, supplement, and cosmetics buyers. Questions like "how long will this last before I need to reorder?" and "will this expire before I finish it?" directly influence conversion. Yet in virtually every Shopify supplement and food store, shelf-life information lives in one of three places: product description paragraph, FAQ tab, or footnote copy — none of which AI shopping agents can parse in a structured way.

When ChatGPT or Perplexity answers "whey protein with longest shelf life" or "skincare products with at least 12 months before expiry," they are querying structured freshness signals — not crawling page text. Stores without bestBeforeDate or shelfLifeMonths additionalProperty are invisible to these queries, even if they explicitly guarantee fresh stock on every page.

Freshness query types that require structured signals

Without vs. with freshness structured data

<p>Best before date printed
on bottom of bottle.
All orders ship with 18+
months of shelf life
remaining.</p>
// Invisible as structured data

{
  "additionalProperty": [{
    "@type": "PropertyValue",
    "propertyID":
      "shelfLifeMonths",
    "value": "24",
    "description":
      "Ships with 24+ months
      of shelf life remaining"
  }]
}

Freshness JSON-LD Patterns

Minimum viable shelf-life guarantee

The shelfLifeMonths additionalProperty declares your freshness policy — how many months of shelf life customers are guaranteed to receive. This is the most durable signal because it doesn't need updating per batch:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Grass-Fed Whey Protein — Vanilla — 2lb",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "shelfLifeMonths",
      "name": "Guaranteed shelf life",
      "value": "18",
      "description": "All orders ship with a minimum of 18 months of shelf life remaining from date of purchase"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "storageConditions",
      "value": "Store in a cool, dry place below 25°C. Refrigerate after opening."
    }
  ]
}

Batch-specific best-before date

For products where you know and can guarantee the current batch expiry, declare it explicitly. This enables AI agents to answer "will this expire before I finish it?" queries with confidence:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Magnesium Glycinate — 120 Capsules",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "bestBeforeDate",
      "name": "Best before",
      "value": "2027-09-30",
      "description": "Current batch best before date — ISO 8601 format"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "shelfLifeMonths",
      "name": "Minimum shelf life on dispatch",
      "value": "18"
    }
  ]
}

Cosmetics period-after-opening (PAO)

For skincare and cosmetics, the period-after-opening (PAO) is the relevant freshness signal — how many months the product remains effective after first use. Declare it alongside the manufacture or best-before date:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Vitamin C Serum — 1oz",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "periodAfterOpeningMonths",
      "name": "Period after opening",
      "value": "12",
      "description": "Use within 12 months of opening for best results — the 12M symbol on packaging"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "shelfLifeMonths",
      "name": "Unopened shelf life",
      "value": "24"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "storageConditions",
      "value": "Store away from direct sunlight and heat. Refrigerate after opening to extend potency."
    }
  ]
}

Food product with best-before and use-by distinction

For food products, include both the best-before date (quality peak) and whether the product is safe to consume beyond it. Use expiryDate only when the product genuinely should not be consumed after that date:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Organic Raw Honey — 12oz",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "bestBeforeDate",
      "name": "Best before",
      "value": "2028-12-31",
      "description": "Best before date — raw honey has indefinite shelf life when stored properly; this date indicates optimal flavor quality"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "indefiniteShelfLife",
      "value": "true",
      "description": "Raw honey does not expire — archaeologists have found 3000-year-old honey still edible"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "storageConditions",
      "value": "Store at room temperature, away from direct sunlight. Do not refrigerate."
    }
  ]
}

Shopify Liquid Implementation

Create freshness metafields in Shopify Admin → Settings → Custom data → Products. Use two types of signals: policy-level (the shelf-life guarantee, set once per product) and batch-level (the current expiry date, updated when new stock arrives):

{% assign shelf_life = product.metafields.freshness.shelf_life_months %}
{% assign batch_expiry = product.metafields.freshness.current_batch_expiry %}
{% assign pao = product.metafields.freshness.period_after_opening %}
{% assign storage = product.metafields.freshness.storage_conditions %}
{% assign indefinite = product.metafields.freshness.indefinite_shelf_life %}

{% if shelf_life or batch_expiry or pao %}
"additionalProperty": [
  {% if shelf_life %}
  {
    "@type": "PropertyValue",
    "propertyID": "shelfLifeMonths",
    "name": "Minimum shelf life on dispatch",
    "value": "{{ shelf_life }}"
  },
  {% endif %}
  {% if batch_expiry %}
  {
    "@type": "PropertyValue",
    "propertyID": "bestBeforeDate",
    "name": "Best before (current batch)",
    "value": "{{ batch_expiry | date: '%Y-%m-%d' }}"
  },
  {% endif %}
  {% if pao %}
  {
    "@type": "PropertyValue",
    "propertyID": "periodAfterOpeningMonths",
    "name": "Period after opening",
    "value": "{{ pao }}"
  },
  {% endif %}
  {% if indefinite %}
  {
    "@type": "PropertyValue",
    "propertyID": "indefiniteShelfLife",
    "value": "true"
  },
  {% endif %}
  {% if storage %}
  {
    "@type": "PropertyValue",
    "propertyID": "storageConditions",
    "value": {{ storage | json }}
  }
  {% endif %}
],
{% endif %}

Freshness Signal Reference by Category

Common Mistakes

Implementation Checklist

• Create freshness metafield namespace in Shopify Admin: shelf_life_months, current_batch_expiry, period_after_opening, storage_conditions
• Fill shelf_life_months for all perishable products (supplements, food, cosmetics)
• Fill current_batch_expiry for batch-tracked products and establish a process to update on each stock receipt
• Add period_after_opening for all leave-on cosmetics and opened-container supplements
• Add freshness additionalProperty block in product.liquid JSON-LD, driven by metafields
• Use Liquid null-guard so properties are only output when metafield is populated
• Format batch expiry dates as ISO 8601 (YYYY-MM-DD) using Liquid date filter
• Add storageConditions for products that require specific storage (refrigeration, UV protection)
• Set indefiniteShelfLife: true for genuinely non-expiring products (raw honey, salt) alongside a quality best-before date
• Run CatalogScan to verify freshness signals appear in your AI readiness score

Related Resources

• Product Condition Structured Data for AI Agents
• Product Material Composition Schema
• Ecommerce Product Schema Markup Guide