Standard · Describe
schema.org JSON-LD (including potentialAction)
Typed facts hidden in the page: organization, product, offer, job, event and actions.
What it is
JSON-LD is a block of structured data in a page that says, in a shared vocabulary, what the page is about: an Organization, a Product with an Offer, a JobPosting, an Event, a LocalBusiness or a Review. potentialAction goes further: it says what can be done, with an EntryPoint an agent can call.
An analogy
At a glance
- Owner
- schema.org (founded by Google, Microsoft, Yahoo and Yandex)
- Maturity
- Stable Stable for a decade. Search engines read the facts. The potentialAction types (ApplyAction, ReserveAction, OrderAction, QuoteAction) are defined but little used.
- Where it lives
- schema.org
- Framework domain
- Describe: Be understood
- What it serves
- Say precisely what you are and offer
- Describe the actions an agent may take
Who should care
The roles this standard touches most. See all the roles on the personas page.
- Engineering and product. Build the access, data, endpoints and actions that agents use, on open standards.
- Marketing and brand. Own the story agents tell: accurate facts, positioning, reputation and presence where agents look.
- Commerce and sales. Make offers, prices, availability and checkout work for agents buying on someone’s behalf.
How to adopt it
- 1
Mark up your organization, products, jobs and events with the matching types.
- 2
Make the markup match what a person sees on the page.
- 3
Add potentialAction where an agent could apply, book, quote or order, with a target it can call.
- 4
Validate the markup and re-check after each site change.
The Institute’s view
This is the foundation of the Describe domain. The facts are read today. Actions are a good bet for being read tomorrow, because they are the natural place to say what an agent can do.
Standards change fast. Last reviewed November 2026.