BuyAction Schema: Let AI Agents Buy From Your Store

What is BuyAction Schema?

BuyAction is a schema.org action type that explicitly tells machines: "you can buy this product here." It is nested inside the standard Product and Offer schema hierarchy that most e-commerce stores already use, but it adds a critical layer of information that almost nobody implements.

The hierarchy works like this: Product describes what the item is. Offer describes the price, availability, and seller. BuyAction describes how to actually purchase it -- the target URL, accepted payment methods, and delivery options.

Without BuyAction, an AI agent looking at your Product schema knows what you sell and how much it costs. But it does not know whether it can initiate a purchase programmatically. BuyAction is the explicit "yes, you can buy this" signal that closes the gap between product discovery and product purchase.

Regular Product and Offer schema tell AI agents what exists and what it costs. BuyAction tells them the purchase is available and provides the machine-readable instructions to complete it. This distinction is subtle but critical in the era of agentic commerce, where AI agents are moving beyond recommendations and into transactions.

Why BuyAction Matters for AI Commerce

AI shopping agents have a fundamental problem: they can discover millions of products through structured data, but they cannot tell which of those products they can actually help a user buy. BuyAction solves this by providing a machine-readable signal that programmatic checkout is available.

According to Semrush research, products with comprehensive structured data (including action types like BuyAction) see a 3.2x increase in AI citations compared to products with basic or no schema. A Princeton study found that GPT-4's accuracy in understanding product pages jumps from 16% to 54% when structured data is present. BuyAction pushes that accuracy even higher by removing ambiguity about purchasability.

The competitive advantage right now is enormous. Estimates suggest that only 10 to 100 domains globally have implemented BuyAction schema. Compare that to the millions of domains with basic Product schema. If you implement BuyAction today, you are in the top fraction of a percent of e-commerce stores in terms of AI agent readiness.

This matters because AI agents are being built to prioritize stores that make transactions easier. When Google's AI Mode, ChatGPT, or Perplexity recommend products, they prefer stores where the full purchase flow is machine-readable. BuyAction is the signal that tells these agents: "this store is ready for you."

The Complete BuyAction JSON-LD Template

Here is a production-ready JSON-LD snippet showing BuyAction nested inside a Product schema. This example uses a realistic outdoor hiking boot product.

{
        "@context": "https://schema.org",
        "@type": "Product",
        "name": "TrailMaster Pro Waterproof Hiking Boots",
        "description": "Waterproof full-grain leather hiking boots with Vibram outsole. Rated for temperatures down to -20F. Available in men's and women's sizes.",
        "image": [
          "https://example.com/images/trailmaster-pro-main.jpg",
          "https://example.com/images/trailmaster-pro-side.jpg",
          "https://example.com/images/trailmaster-pro-sole.jpg"
        ],
        "brand": {
          "@type": "Brand",
          "name": "SummitGear"
        },
        "sku": "SG-TMP-001",
        "gtin13": "0614141999996",
        "mpn": "TMP-2026-WP",
        "aggregateRating": {
          "@type": "AggregateRating",
          "ratingValue": "4.7",
          "reviewCount": "842"
        },
        "offers": {
          "@type": "Offer",
          "url": "https://example.com/products/trailmaster-pro-hiking-boots",
          "price": "219.99",
          "priceCurrency": "USD",
          "priceValidUntil": "2026-12-31",
          "availability": "https://schema.org/InStock",
          "itemCondition": "https://schema.org/NewCondition",
          "seller": {
            "@type": "Organization",
            "name": "SummitGear Outdoor Co."
          },
          "shippingDetails": {
            "@type": "OfferShippingDetails",
            "shippingRate": {
              "@type": "MonetaryAmount",
              "value": "0",
              "currency": "USD"
            },
            "deliveryTime": {
              "@type": "ShippingDeliveryTime",
              "handlingTime": {
              "@type": "QuantitativeValue",
              "minValue": "0",
              "maxValue": "1",
              "unitCode": "d"
              },
              "transitTime": {
              "@type": "QuantitativeValue",
              "minValue": "3",
              "maxValue": "5",
              "unitCode": "d"
              }
            }
          },
          "potentialAction": {
            "@type": "BuyAction",
            "target": {
              "@type": "EntryPoint",
              "urlTemplate": "https://example.com/cart/add?product=SG-TMP-001",
              "actionPlatform": [
              "https://schema.org/DesktopWebPlatform",
              "https://schema.org/MobileWebPlatform"
              ]
            },
            "deliveryMethod": [
              "http://purl.org/goodrelations/v1#DeliveryModeParcelService",
              "http://purl.org/goodrelations/v1#DeliveryModeOwnFleet"
            ],
            "paymentAccepted": [
              "http://purl.org/goodrelations/v1#ByBankTransferInAdvance",
              "http://purl.org/goodrelations/v1#PayPal",
              "http://purl.org/goodrelations/v1#Visa",
              "http://purl.org/goodrelations/v1#MasterCard",
              "http://purl.org/goodrelations/v1#AmericanExpress"
            ]
          }
        }
      }

Key Properties Explained

• target -- The EntryPoint with a urlTemplate that points to the add-to-cart or checkout URL. This is the URL an AI agent would use to initiate a purchase. Use a URL that actually adds the product to the cart or starts checkout.
• actionPlatform -- Specifies which platforms the buy action is available on. Include both DesktopWebPlatform and MobileWebPlatform for maximum coverage.
• deliveryMethod -- How the product is delivered. Use GoodRelations delivery method URIs. Common values include DeliveryModeParcelService for shipped items and DeliveryModeOwnFleet for local delivery.
• paymentAccepted -- Which payment methods are accepted. Use GoodRelations payment method URIs. List every payment method your store supports.