XooCode(){

OrderAction

OrderAction is an Action subtype (via TradeAction) for placing an order for delivery or shipment. It adds 1 property: deliveryMethod (a DeliveryMethod enum: OnSitePickup, LockerDelivery, ParcelService). It inherits price, priceCurrency, and priceSpecification from TradeAction. Use it as a potentialAction when you need to express that a product can be ordered and shipped, with the delivery method specified.

Like BuyAction, OrderAction is less common than direct Offer markup. Most ecommerce sites express delivery options through shippingDetails on Offer. OrderAction is useful in email markup (Gmail order confirmation cards) and in API contexts where the action represents a specific ordering endpoint.

Full example of schema.org/OrderAction json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional
schema.org/OrderAction
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "XooTee Classic",
  "potentialAction": {
    "@type": "OrderAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://xoocode.com/shop/xootee-classic/order"
    },
    "deliveryMethod": "https://schema.org/ParcelService",
    "price": "495.00",
    "priceCurrency": "DKK"
  }
}
</script>

Minimal valid version

The smallest markup that still produces a valid OrderAction entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/OrderAction (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "XooTee Classic",
  "potentialAction": {
    "@type": "OrderAction",
    "target": "https://xoocode.com/shop/xootee-classic/order",
    "deliveryMethod": "https://schema.org/ParcelService"
  }
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

Common OrderAction mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

  1. 01

    deliveryMethod as plain text

    Wrong
    "deliveryMethod": "Standard shipping"
    Right
    "deliveryMethod": "https://schema.org/ParcelService"

    deliveryMethod takes a DeliveryMethod enum as a full schema.org URL. The three values are ParcelService, OnSitePickup, and LockerDelivery.

Schema properties in this example

OrderActionTradeActionActionProductpotentialActiontargetEntryPointurlTemplatedeliveryMethodDeliveryMethodpricepriceCurrency

Comments

Loading comments...

Leave a comment