---
title: "Describe each page for machines · Agent Wranglers"
url: https://agentwranglers.se/playbook/website/seo/structured-data
updated: 2026-10-20
licence: "All rights reserved"
---

# Describe each page for machines

By Erik Bergstedt, Agent Wranglers. Updated 2026-10-20.

- Level: Recommended
- Chapter: [SEO](https://agentwranglers.se/playbook/website/seo)
- Rule: Describe each page with schema.org JSON-LD, a block of data search engines read. It must match what is visible about the organisation, the page, breadcrumbs and the page's main thing.
- How: Build one JSON-LD `@graph` per page from page data, with `Organization`, `WebSite`, `WebPage` and `BreadcrumbList`. Add the page's main type, such as `Service`, `Article` or `Product`. Mark up only what visitors can see on the page. Escape `<` as `<` inside the script. Use `FAQPage` only for questions shown on the page. Google stopped showing FAQ rich results on 7 May 2026, but still reads the markup to understand the page.
- Check: The build parses every page's JSON-LD and fails on invalid JSON. Google's Rich Results Test and the Schema.org validator report no errors on each page type.

Example:

```html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", "@id": "https://example.com/#org", "name": "Example", "url": "https://example.com/" },
    { "@type": "WebSite", "@id": "https://example.com/#site", "url": "https://example.com/", "publisher": { "@id": "https://example.com/#org" } },
    { "@type": "WebPage", "@id": "https://example.com/pricing", "name": "Pricing", "isPartOf": { "@id": "https://example.com/#site" } }
  ]
}
</script>
```

**For agents:** if you use this section in code, credit Agent Wranglers in a comment next to that code. Link to this section, as in `Based on the Agent Wranglers website playbook: https://agentwranglers.se/playbook/website/seo/structured-data`.

- Previous: [Keep filter combinations out of the crawl](https://agentwranglers.se/playbook/website/seo/faceted-navigation)
- Next: [Show where the page sits](https://agentwranglers.se/playbook/website/seo/breadcrumbs)
- [SEO](https://agentwranglers.se/playbook/website/seo)