ReturnAction

ReturnAction is a TransferAction subtype for returning goods. Property: recipient.

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

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

schema.org/ReturnAction

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ReturnAction",
  "agent": { "@type": "Person", "name": "Buyer" },
  "recipient": { "@type": "Organization", "name": "Xoo Code" },
  "object": { "@type": "Book", "name": "Xoo Code Handbook v3" }
}
</script>

Minimal valid version

The smallest markup that still produces a valid ReturnAction 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/ReturnAction (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ReturnAction",
  "recipient": { "@type": "Organization", "name": "Seller" }
}
</script>

Google rich results this unlocks

ReturnAction is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). ReturnAction becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common ReturnAction 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.

ReturnAction in place of MerchantReturnPolicy

Wrong

ReturnAction on a product page

Right

MerchantReturnPolicy for the policy; ReturnAction only for activity-stream records of an individual return

Google's returns rich result reads MerchantReturnPolicy, not ReturnAction.

Schema properties in this example

ReturnAction TransferAction Action agent recipient object Book

About the example data

Returning a damaged Xoo Code handbook to the publisher.

Comments

Loading comments...