What is JSON-LD and why use it for articles?

JSON-LD is a JSON-based format for embedding structured data, recommended by Google. An Article schema describes a page to search engines so it can qualify for rich results such as Top Stories and enhanced snippets, and helps engines understand the author, dates, and publisher.

What is the difference between Article, NewsArticle, and BlogPosting?

They are increasingly specific subtypes. Article is the general type, NewsArticle is for journalistic news content, and BlogPosting is for blog posts. Pick the one that best matches your content; the required fields are the same and search engines treat them similarly.

Which fields are required?

Google recommends at least headline, image, datePublished, and either author or publisher with a logo. This builder always emits headline, author, datePublished, dateModified, publisher with logo, and mainEntityOfPage so your markup is complete and eligible for enhanced results.

How should dates be formatted?

Dates must be in ISO 8601 format, ideally with a timezone offset, for example 2026-06-06T09:00:00+00:00. The tool converts the dates you pick into ISO 8601 automatically so search engines parse them reliably.

Where do I put the script tag?

Place the script block anywhere in the head or body of the matching article page. It must be on the same page as the content it describes, and the values, such as headline and dates, must match what users actually see.

JSON-LD Article Schema Builder

Article structured data that actually validates

Google’s rich results for articles depend on clean, complete JSON-LD. Hand-writing it means juggling nested publisher and logo objects, ISO date formats, and escaping rules — all easy to get wrong. This builder takes plain inputs and emits a correctly structured, properly escaped <script type="application/ld+json"> block you can paste straight onto the page.

How it works

The tool constructs a schema.org Article object and serialises it as JSON-LD:

@context is https://schema.org and @type is your chosen subtype (Article, NewsArticle, or BlogPosting).
headline, description, and image describe the content.
author is emitted as a Person object with a name.
publisher is an Organization object containing a nested ImageObject logo.
datePublished and dateModified are converted to ISO 8601.
mainEntityOfPage is a WebPage reference to the canonical URL.

The object is built in JavaScript and serialised with JSON.stringify, so every string is escaped correctly — quotes, backslashes, and newlines in your text cannot produce invalid JSON. The output updates live as you edit.

Tips and example

A minimal valid block looks like this once generated:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How we cut load time in half",
  "datePublished": "2026-06-06T09:00:00.000Z",
  "author": { "@type": "Person", "name": "Jane Smith" }
}
</script>

Keep headline under about 110 characters; Google may ignore longer headlines.
Make dateModified accurate — updating it when you genuinely revise the article can help freshness signals.
Ensure the image URL is a high-resolution, publicly reachable asset; thin or broken images disqualify rich results.
After publishing, test the page in the Rich Results Test to confirm it is eligible.

JSON-LD Article Schema Builder

Email me this result

Article structured data that actually validates

How it works

Tips and example