Browse documentation
Documentation foundation

JSON-LD basics

JSON-LD is a way to describe your page in machine-readable JSON. Browsers ignore it. Search engines and many AI crawlers use it to understand entities, content types, and relationships on a URL.

You place it in a <script type="application/ld+json"> block, usually in the document head. The JSON must match what people actually see on the page.

Common types

  • Article for blog posts, news, and long-form editorial pages.
  • Organization for your brand on the homepage.
  • FAQPage when you publish visible questions and answers.

Learn more: Organization schema, Article schema, and FAQ schema.

Generate markup in SEO Perception

Use our free JSON-LD generator to build Article, Organization, or FAQ markup from your crawl data. Open it from SEO Possibilities when we detect a gap, or visit the tool directly.

For a broader view of robots.txt, llms.txt, and structured data together, see AI discoverability.

Stay in the loop

Weekly SEO teardowns, algorithm update alerts, and performance tactics—when we publish them.

We respect your privacy: we do not sell your email or spam you.

SEO Perception

We take all the dry, technical SEO data nobody wants to read, connect the dots with AI and decades of SEO expertise, and show you the fixes that matter most plus the opportunities with the biggest upside.


Google, PageSpeed, and PageSpeed Insights are trademarks of Google LLC. SEO Perception is not endorsed by or affiliated with Google. We use Google’s public PageSpeed Insights service because we find it useful for site owners.

© 2024 - 2026 SEO Perception. All rights reserved.

Built with love by Larsik Corp.