Implementation
Structured Metadata
Using schema.org, JSON-LD, and semantic HTML to make content machine-readable.
Structured metadata makes the content of a page machine-readable without changing what people see. It is the cheapest, highest-leverage AX improvement for most websites, and it builds on established standards.
schema.org · JSON-LD · HTMLStart with semantic HTML
Before adding any metadata, check the markup itself. Agents that read pages benefit from the same structure assistive technology uses:
- One
h1per page, and headings that describe their sections. - Real
buttonandaelements, not clickabledivs. - Every form control has a visible, associated
label. - Tables use
thwithscopefor headers. - Images that carry information have meaningful
alttext. - State is expressed with attributes such as
aria-pressed,aria-expanded, anddisabled.
<!-- Before: meaning carried by appearance -->
<div class="sz-opt active" onclick="pick(42)">42</div>
<!-- After: meaning carried by markup -->
<fieldset>
<legend>Size (EU)</legend>
<label><input type="radio" name="size" value="42" checked /> 42</label>
</fieldset>Add schema.org with JSON-LD
schema.org provides a widely adopted vocabulary for common things: products, offers, events, organizations, articles, FAQs, and more. Embed it as JSON-LD in the page.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"sku": "TRAIL-RUNNER-42-BLK",
"name": "Trail Runner",
"color": "Black",
"size": "EU 42",
"brand": { "@type": "Brand", "name": "Northwind" },
"offers": {
"@type": "Offer",
"price": "129.00",
"priceCurrency": "EUR",
"availability": "https://schema.org/InStock",
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"merchantReturnDays": 30,
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow"
}
}
}
</script>Go beyond schema.org where needed
schema.org covers public, descriptive facts well. Application-specific data (cart state, workflow steps, available actions) needs your own representation. Offer it as an alternate:
<link rel="alternate" type="application/json" href="/products/trail-runner.json" />Or with content negotiation on the same URL:
GET /products/trail-runner
Accept: application/jsonDocument your own fields and keep names consistent with the UI.
llms.txt
llms.txt is a community proposal for a Markdown file at the site root that summarizes a site for language models and links to key resources. It is lightweight and readable by people too. If you publish one, keep it short and link onward to your manifest and docs. This site publishes /llms.txt as an example.
Checklist
- Semantic HTML with labelled controls.
- JSON-LD for public resources, generated from source data.
- Explicit units and currencies in every value.
- An alternate JSON representation for application data.
- Links from human pages to machine-readable alternates.
Related
Last updated 2026-10-06. AX Framework documentation describes proposals unless a section is marked as an established standard.