Article Schema Explained: How to Add Article & BlogPosting JSON-LD
Understand with AI
Discuss with your preferred AI assistant
Only `headline` is strictly required — but adding the recommended fields unlocks far more rich-result eligibility.
Google recommends featured images at least 1200 pixels wide, ideally in multiple aspect ratios.
Keep headlines under roughly 110 characters so search engines do not truncate them.
Article schema is one of the highest-leverage pieces of structured data you can add to a content site. It tells Google and other search engines exactly what a page is — its headline, who wrote it, who published it, when it went live, and what image represents it. Done right, it makes your articles eligible for rich results, strengthens your presence in Google Discover and Top Stories, and gives AI search engines clean, machine-readable facts to cite.
This guide explains what Article schema is, how the Article, BlogPosting, and NewsArticle types differ, which properties actually matter, and how to add the JSON-LD to your pages without writing a line of code.
What Is Article Schema?
Article schema is structured data — written in the JSON-LD format recommended by Google — that describes a news, blog, or editorial page using the schema.org vocabulary. Instead of asking a crawler to infer your headline and author from messy HTML, you hand it a small, explicit block of data it can trust.
That block lives inside a <script type="application/ld+json"> tag in your page's HTML. It does not change how the page looks to readers; it changes how machines understand it. Search engines use it to render richer search listings, surface your content in specialized features, and assess the credibility signals (author, publisher, dates) that increasingly feed both classic SEO and AI Overviews.
Article vs. BlogPosting vs. NewsArticle
All three are part of the same schema.org family — NewsArticle and BlogPosting are both subtypes of Article — so they share the same core properties. Choosing the most specific accurate type gives search engines the clearest signal:
| Type | Best for | Notes |
|---|---|---|
| Article | General guides, evergreen editorial, knowledge-base pages | The safe default when nothing more specific fits. |
| BlogPosting | Posts in a dated blog feed | Signals informal, regularly published content. |
| NewsArticle | Time-sensitive news and press coverage | Required for eligibility in Top Stories and the News tab. |
If you publish a company blog, use BlogPosting. If you run a newsroom or cover breaking events, use NewsArticle. When in doubt, plain Article is always valid.
The Properties That Matter
Google's documentation lists one required property and several strongly recommended ones. A complete, trustworthy markup includes all of them:
- headline (required) — the article title. Keep it under ~110 characters so it is not truncated.
- image — a high-resolution URL (Google recommends at least 1200px wide). Multiple aspect ratios are better still.
- datePublished — when the article first went live, in ISO 8601 format.
- dateModified — when it was last meaningfully updated; helps freshness signals.
- author — a Person or Organization, ideally with a
urlpointing to an author bio for E-E-A-T. - publisher — an Organization with a
nameand alogo(an ImageObject). - mainEntityOfPage — the canonical URL of the article, so the markup is unambiguously tied to one page.
How to Add Article Schema to Your Page
1. Generate the JSON-LD
Fill in your headline, URL, description, author, publisher, image, and dates in the generator above. It produces clean, valid JSON-LD instantly and flags any missing recommended fields. Only properties you actually fill in are included, so the output never contains empty or placeholder values.
2. Paste the script tag into your page
Copy the <script type="application/ld+json"> block and paste it into the page's HTML — anywhere in the <head> or near the end of the <body> works. On a CMS like WordPress you can drop it into a custom HTML block, a header-script field, or an SEO plugin's schema box.
3. Validate before you ship
Run the URL (or paste the snippet) through Google's Rich Results Test and the Schema Markup Validator. Fix any errors flagged as required, and address warnings where you can — they map directly to richer eligibility.
4. Keep dates honest
Update dateModified whenever you make a substantive edit, and never backdate datePublished to game freshness. Search engines cross-check these against your sitemap and crawl history.
Article Schema Best Practices
- Match the visible page. The headline, author, and dates in your schema must match what readers actually see — mismatches can trigger manual actions.
- Use the most specific type. Prefer BlogPosting or NewsArticle over generic Article when they apply.
- Give authors a URL. Linking
author.urlto a real bio page is one of the strongest E-E-A-T signals you can send. - Serve a real, large image. A live, crawlable image URL at 1200px+ wide maximizes rich-result and Discover eligibility.
- One canonical per page. Point
mainEntityOfPageat the canonical URL to avoid duplicate-content confusion.
Common Article Schema Mistakes
- Leaving out
datePublished— the single most common reason articles miss freshness-driven features. - Using a tiny or broken image URL that Google cannot fetch at the recommended resolution.
- Setting
publisherwithout a logo, or omitting the publisher entirely on news content. - Headlines longer than ~110 characters that get truncated in results.
- Schema that contradicts the visible page (different author, different date).
Expert Tips
Always validate before shipping
Run every page through Google’s Rich Results Test and the Schema Markup Validator. Fix required errors first, then clear warnings — each one maps to richer eligibility.
Keep schema in sync with the page
The headline, author, and dates in your JSON-LD must match what readers actually see. Update dateModified on real edits, and never backdate datePublished to fake freshness.
Frequently Asked Questions
What is Article schema used for?
Article schema is structured data that tells search engines a page is a news, blog, or editorial article and supplies its headline, author, publisher, dates, and image. It makes the page eligible for rich results, Google Discover, and Top Stories, and gives AI search engines clean facts to cite.
Is Article schema required for SEO?
It is not strictly required to rank, but it is strongly recommended. Article schema is a prerequisite for several Google features (like Top Stories for NewsArticle) and reinforces the author and publisher credibility signals that increasingly influence both traditional rankings and AI Overviews.
What is the difference between Article, BlogPosting, and NewsArticle?
They share the same core properties because BlogPosting and NewsArticle are subtypes of Article. Use BlogPosting for posts in a dated blog, NewsArticle for time-sensitive news (required for Top Stories), and plain Article for general or evergreen editorial content.
Where do I add the Article JSON-LD on my page?
Paste the generated <script type="application/ld+json"> block into the HTML of the article page — anywhere in the <head> or near the end of the <body> . On most CMS platforms you can use a custom HTML block, a header-scripts field, or an SEO plugin's structured-data setting.