XooCode(){

FindAction

FindAction is an Action subtype for locating or monitoring something: tracking a package, checking an order status, discovering a new item. Direct subtypes are CheckAction, DiscoverAction, and TrackAction. It adds no properties of its own.

FindAction is most commonly seen in email markup (Gmail order-tracking cards use TrackAction) and in activity-stream contexts. For order tracking specifically, the Order type exposes orderStatus and trackingUrl directly, which is what consumers actually read.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/FindAction
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TrackAction",
  "name": "Track XooTee order XT-2026-1407",
  "agent": { "@type": "Person", "name": "Order Recipient" },
  "object": { "@type": "Order", "orderNumber": "XT-2026-1407" },
  "target": { "@type": "EntryPoint", "urlTemplate": "https://xoocode.com/orders/XT-2026-1407/tracking" },
  "actionStatus": "https://schema.org/ActiveActionStatus"
}
</script>

Minimal valid version

The smallest markup that still produces a valid FindAction 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/FindAction (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TrackAction",
  "agent": { "@type": "Person", "name": "Recipient" },
  "object": { "@type": "Order", "orderNumber": "XT-2026-1407" },
  "target": "https://xoocode.com/orders/XT-2026-1407/tracking"
}
</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 FindAction 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

    FindAction where Order.orderStatus would suffice

    Wrong
    Separate FindAction blocks on each order page duplicating what Order carries
    Right
    Use Order.orderStatus and Order.trackingUrl for shipment info

    Google Search and Gmail already read Order.orderStatus and trackingUrl for cards. FindAction / TrackAction is useful in ActivityStreams and email markup, not as a parallel to Order properties on the order page itself.

Schema properties in this example

FindActionTrackActionActionnameagentPersonobjectOrderorderNumbertargetEntryPointurlTemplateactionStatusActiveActionStatus

About the example data

Tracking the shipment of a XooTee order from the Dunmore shop to a customer address.

Comments

Loading comments...

Leave a comment