SellAction

SellAction is a TradeAction subtype for transferring ownership in exchange for payment. Properties: buyer (Person / Organization) and warrantyPromise (WarrantyPromise).

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

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

schema.org/SellAction

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SellAction",
  "agent": { "@type": "Organization", "name": "Xoo Garage" },
  "object": { "@type": "Car", "name": "1967 Volvo 122S Amazon" },
  "buyer": { "@type": "Person", "name": "Sam Xoo" },
  "price": 18500,
  "priceCurrency": "EUR"
}
</script>

Minimal valid version

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

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SellAction",
  "agent": { "@type": "Organization", "name": "Seller" },
  "buyer": { "@type": "Person", "name": "Buyer" }
}
</script>

Google rich results this unlocks

SellAction 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). SellAction becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

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

01
Missing buyer
Wrong
```
SellAction with only agent + object
```
Right
```
Include buyer — the counterparty makes it a Sell vs a Buy
```
Buy and Sell are mirror actions; the counterparty property distinguishes them.

Schema properties in this example

SellAction TradeAction Action agent object Car buyer Person warrantyPromise price priceCurrency

About the example data

Xoo Garage selling the 1967 Volvo 122S Amazon.

Comments

Loading comments...