Shopify Booking & Appointment Product Schema: ReserveAction & BookAction for AI Agents

Why Booking Schema Matters for AI Agent Discovery

The query "book a [service]" is fundamentally different from "buy a [product]." Shoppers asking to book have high commercial intent and expect to interact with a scheduling flow — not just see a product page. AI agents are increasingly learning to distinguish between:

• Informational results (what is this service?)
• Product recommendations (where can I buy this?)
• Bookable service recommendations (where can I book this right now?)

The potentialAction property on Service declares that this listing has an actionable next step — in this case, a booking flow. AI agents that encounter a BookAction in a service's structured data can:

• Surface your listing specifically for booking-intent queries
• Display a "Book now" deep link in AI-generated results
• Feed your service into booking aggregators that use structured data as input
• Distinguish your bookable service from static informational pages about the same service type

ReserveAction vs. BookAction: Which to Use

Most Shopify bookable services collect payment at checkout (because Shopify's cart and checkout are the payment flow). Use BookAction for these. If you offer free bookings or consultations where no payment is taken when scheduling, use ReserveAction.

Booking Schema Properties Reference

BookAction JSON-LD Example: Hair Salon Appointment

{
  "@context": "https://schema.org",
  "@type": "Service",
  "name": "Balayage Color & Style — Full Service",
  "serviceType": "Hair Coloring",
  "description": "Full balayage color service with toner, blow-dry, and style finish. 3–4 hours. Book online and choose your stylist.",
  "provider": {
    "@type": "Organization",
    "name": "Luminary Hair Studio",
    "url": "https://luminary-hair.myshopify.com",
    "telephone": "+1-512-555-0199"
  },
  "areaServed": {
    "@type": "City",
    "name": "Austin",
    "containedInPlace": {"@type": "State", "name": "Texas"}
  },
  "availableChannel": {
    "@type": "ServiceChannel",
    "serviceUrl": "https://luminary-hair.myshopify.com/products/balayage-full-service",
    "serviceLocation": {
      "@type": "Place",
      "name": "Luminary Hair Studio — South Congress",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "1204 S Congress Ave",
        "addressLocality": "Austin",
        "addressRegion": "TX",
        "postalCode": "78704"
      }
    }
  },
  "offers": {
    "@type": "Offer",
    "price": "245.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "url": "https://luminary-hair.myshopify.com/products/balayage-full-service"
  },
  "potentialAction": {
    "@type": "BookAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://luminary-hair.myshopify.com/products/balayage-full-service",
      "inLanguage": "en"
    },
    "actionStatus": "https://schema.org/PotentialActionStatus",
    "provider": {
      "@type": "Organization",
      "name": "Luminary Hair Studio"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.9",
    "reviewCount": "87",
    "bestRating": "5"
  }
}

ReserveAction JSON-LD Example: Free Consultation Call

{
  "@context": "https://schema.org",
  "@type": "Service",
  "name": "Free 30-Minute Strategy Consultation",
  "serviceType": "Business Consulting",
  "description": "A free 30-minute video call to audit your Shopify store's AI readiness and identify the top 3 structured data gaps. No payment required. Book via Calendly.",
  "provider": {
    "@type": "Organization",
    "name": "CatalogScan",
    "url": "https://catalogscan.com"
  },
  "areaServed": "Online",
  "availableChannel": {
    "@type": "ServiceChannel",
    "serviceUrl": "https://catalogscan.com/products/free-consultation"
  },
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "url": "https://catalogscan.com/products/free-consultation"
  },
  "potentialAction": {
    "@type": "ReserveAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://calendly.com/catalogscan/strategy-call",
      "inLanguage": "en"
    },
    "actionStatus": "https://schema.org/PotentialActionStatus"
  }
}

Shopify Liquid Template: BookAction Implementation

{% comment %} product.liquid — BookAction for bookable service products {% endcomment %}
{% assign is_bookable = false %}
{% if product.tags contains 'schema-bookable' %}
  {% assign is_bookable = true %}
{% endif %}

{% assign booking_url = product.metafields.seo.booking_url.value %}
{% unless booking_url %}
  {% assign booking_url = "https://" | append: shop.domain | append: product.url %}
{% endunless %}

Required metafields for bookable service products

Booking Schema for Common Shopify Service Categories

Common Booking Schema Mistakes on Shopify

CatalogScan Booking Schema Checks

CatalogScan's AI Readiness scan identifies Shopify products that appear to be bookable services (by tag, product_type, or keywords like "session", "appointment", "booking", "consultation") and checks whether they include a potentialAction BookAction or ReserveAction in their structured data. Bookable service products without a booking action receive a booking-signal gap warning. The scan also validates that the target EntryPoint has a non-empty urlTemplate that resolves to a real page.

Related guides: Service product schema for Shopify · Local pickup and BOPIS schema · Store location LocalBusiness schema · Shopify schema markup overview