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

The nutrition label on the packet: the same facts, in the same layout, for every product.

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.

Framework personas →

How to adopt it

  1. 1

    Mark up your organization, products, jobs and events with the matching types.

  2. 2

    Make the markup match what a person sees on the page.

  3. 3

    Add potentialAction where an agent could apply, book, quote or order, with a target it can call.

  4. 4

    Validate the markup and re-check after each site change.

The Institute’s view

Adopt

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.

← Back to the Standards Map