Home/Guides/Schema.org & JSON-LD
Structured Data

Schema.org and JSON-LD

Structured data helps machines understand the page type, the entities being described and how the page connects to the rest of the site.

Key takeaways
  • JSON-LD is a widely used format for adding structured data to HTML pages.
  • Schema should match visible content and the real purpose of the page.
  • Organization, WebSite, Article, FAQPage and WebApplication are common starting points for many sites.

What structured data does

Structured data is machine-readable context. It does not replace visible content, but it can help crawlers identify organizations, articles, products, FAQs, software applications and key entities.

Why JSON-LD is popular

JSON-LD is usually placed in a script tag in the head or body. It is easier to maintain than inline microdata and can express page-level relationships clearly.

Choose the right schema type

Use schema types that match the page. Guide pages may use Article or TechArticle; a homepage may use Organization, WebSite and WebApplication; visible FAQs may use FAQPage.

Avoid schema spam

Do not add claims, reviews, prices, FAQs or product data that users cannot see. Misleading structured data can create trust and validation problems.

Schema and AI visibility

AI systems benefit from entity clarity. Schema can reinforce the publisher, page type, topic and relationships across the broader site.

Practical checklist

  • Add Organization and WebSite schema to important site pages.
  • Use Article or TechArticle for guide content.
  • Use FAQPage only when questions are visible.
  • Keep @id and url values canonical.
  • Validate JSON syntax before publishing.
  • Update schema when page titles, URLs or content types change.

Implementation order

  1. Identify the real page type: guide, service, product, tool, contact or pricing.
  2. Add only schema fields that match visible content.
  3. Use consistent @id values for Organization and WebSite entities.
  4. Validate with Rich Results Test or Schema Markup Validator.

Frequently asked questions

Should every page use the same schema?

No. Structured data should match the real page type and visible content, such as Article for guides, Offer for pricing and WebApplication for tools.

Can hidden claims be added to schema?

No. Structured data should support visible page content. Adding claims users cannot see can create trust and policy issues.

Why is JSON-LD commonly used?

JSON-LD makes it easier to add structured data without changing visible HTML and is widely supported by search engines.