Structured Data (JSON-LD) Basics: Article, FAQ, Org
Yuuuk94·Published
Summary
Structured data describes facts like "this page is an article, written by this person, on this date" using a shared vocabulary (Schema.org). Of the available formats, Google recommends JSON-LD in a <script type="application/ld+json"> tag.
Structured data doesn't raise rankings. It makes pages eligible for rich results (breadcrumbs, product prices and so on) and helps search engines and AI interpret the page correctly.
01What JSON-LD looks like
JSON-LD can go anywhere in the HTML, usually in <head> or at the end of the body. @context names the vocabulary (Schema.org) and @type says what the data describes.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "How to Check robots.txt and 5 Common Mistakes",
"datePublished": "2026-11-12",
"dateModified": "2026-11-12",
"author": { "@type": "Person", "name": "Author Name" },
"publisher": { "@type": "Organization", "name": "META_SCAN.BIZ" }
}
</script>Microdata and RDFa mix the markup into HTML attributes. JSON-LD stays separate from the visible markup, which makes it easier to maintain: your framework just serializes data to JSON.
02The types you will use most
| Type | Where | Key properties |
|---|---|---|
| Organization | Home page | name, url, logo, sameAs (official profiles) |
| WebSite | Home page | name, url |
| Article / BlogPosting | Blog posts, news | headline, datePublished, dateModified, author |
| BreadcrumbList | Pages in a hierarchy | itemListElement (position, name, item) |
| FAQPage | Pages with a visible Q&A list | mainEntity (Question, acceptedAnswer) |
| Product | Product detail pages | name, offers (price), aggregateRating |
| SoftwareApplication / WebApplication | Tool or app pages | name, applicationCategory, offers |
META_SCAN's blog posts carry Article, BreadcrumbList and FAQPage; the home page carries WebApplication, WebSite and Organization. Pick what fits each page; more isn't better.
03How much to expect from rich results
Structured data was once sold as "add it and your results get fancy", but Google has narrowed rich results considerably over the past few years.
- FAQ rich results: since 2023 they are shown only for well-known, authoritative government and health sites. Other sites can add FAQPage but won't get the expandable questions in results.
- HowTo rich results: discontinued in 2023.
- Still active: breadcrumbs (BreadcrumbList), product price and reviews (Product), events, recipes, job postings and more still appear as rich results.
04Rules to follow
- Match the visible content: reviews or FAQs that exist only in structured data violate Google's policies and can lead to a manual action.
- Different per page: giving every article the same headline or date is a common bug. Generate it from page data.
- Fill required properties: each type has properties Google requires; without them, the page isn't eligible.
- Date format: use ISO 8601, like
2026-11-12or2026-11-12T09:00:00+09:00. - Full URLs: url, logo and image take complete
https://addresses.
05How to validate it
| Tool | Use |
|---|---|
| Google Rich Results Test | Whether the page is eligible for Google rich results and has all required properties |
| Schema Markup Validator | Checks against the full Schema.org vocabulary, regardless of Google support |
| Search Console > Enhancements | Tracks valid and invalid items per type across the site |
Before release, run code or a URL through the Rich Results Test; after release, watch the Enhancements reports for new errors. META_SCAN's AI signals card also shows whether a page has JSON-LD and which types it contains.
06Adding it in a framework
In Next.js (App Router), the documented approach is to render <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(data) }} /> in the page component. Keeping a separate function that builds the object from your content makes it easy to test. In WordPress, most SEO plugins add Article, Organization and BreadcrumbList automatically.
FAQ
- Q. Does structured data improve rankings?
- Google says structured data isn't a ranking factor. There can be an indirect effect when a rich result improves click-through.
- Q. Can I have more than one JSON-LD block?
- Yes. Use one script tag per type or combine them with
@graph. Just avoid declaring the same fact differently in two places. - Q. Do other search engines read JSON-LD?
- Bing and other major engines support Schema.org structured data including JSON-LD. Which types produce rich results differs by engine, so check each one's documentation.
Related reading
References
How does your site do?
Enter one URL to run the free SEO/AEO/GEO checklist, including everything covered in this post.
Check for free