# schema.org JSON-LD (including potentialAction)

> Typed facts hidden in the page: organization, product, offer, job, event and actions.

Source: https://agentrelations.org/standards/schema-org

## 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](https://schema.org/)

Framework domain

[Describe: Be understood](https://agentrelations.org/framework/domains/describe)

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 →](https://agentrelations.org/framework/personas)

## How to adopt it

1. 1
Mark up your organization, products, jobs and events with the matching types.
1. 2
Make the markup match what a person sees on the page.
1. 3
Add potentialAction where an agent could apply, book, quote or order, with a target it can call.
1. 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](https://agentrelations.org/standards)
