How to use the Article Schema Generator
Article schema qualifies blog posts and news content for Top Stories, Discover, and AMP carousels. The required fields are strict — missing one disqualifies the rich result entirely.
Pick Article, NewsArticle, or BlogPosting
Article is the broadest type. NewsArticle is for journalistic content and qualifies for Top Stories. BlogPosting is for blog posts. Don't stack — pick the most specific one that fits.
Fill the required fields
headline (under 110 chars), datePublished (ISO 8601), author (Person or Organization), image (1200 × 675+ minimum), publisher with logo (112 × 112 minimum).
Add dateModified for fresh content
If the article has been updated since publish, set dateModified. Google uses it to surface fresh content in Top Stories and Discover.
Paste into and validate
Wrap in <script type="application/ld+json">. Validate with Rich Results Test — Article schema has the most rejection reasons of any type, so always validate before deploy.
Why Article schema matters for content sites
Article schema is the gateway to Google's premium content surfaces — Top Stories, Discover, the news carousel, and Recipe-style image-led results. Without it, your articles are eligible only for the standard 10-blue-link result.
What Article schema unlocks
- Top Stories carousel — featured news box at the top of mobile SERPs.
- Google Discover — the personalized feed on Android home screens.
- Article rich result — bigger image, byline, publish date in standard SERPs.
- Google News — eligibility for inclusion in news.google.com.
Required vs recommended fields
The required fields (no exceptions) are headline, image, datePublished, author, publisher. The recommended fields that materially affect rich-result eligibility:
dateModified— for evergreen content, surface freshness.description— short summary, distinct from headline.articleBody— full article text (improves understanding).mainEntityOfPage— canonical URL of the article.
Image requirements (the most common failure)
- Minimum 1200 × 675 pixels (16:9 ratio).
- Provide multiple aspect ratios (1:1, 4:3, 16:9) when possible.
- Absolute https URL.
- Crawlable (not blocked by robots.txt).
- Direct image file (not a Cloudflare cache or redirect).
Frequently asked questions
What is Article schema?
Article schema is JSON-LD structured data using Article, NewsArticle, or BlogPosting types that marks up articles, blog posts, and news content. Google uses it to qualify pages for rich results including Top Stories, Discover, and the article carousel.
Should I use Article, NewsArticle, or BlogPosting?
Use the most specific type that fits. NewsArticle for journalistic news (qualifies for Top Stories). BlogPosting for blog posts. Article for everything else (essays, reviews, longform). Don't stack multiple types on one page — Google may pick the wrong one.
What image size does Article schema require?
Google requires images at least 1200 pixels wide. Best practice is to provide multiple aspect ratios (16:9, 4:3, 1:1) so Google can pick the best one for each surface — Top Stories prefers 16:9, Discover prefers 1:1. All images must be absolute https URLs and crawlable.
Does Article schema help me rank in Google News?
Article (specifically NewsArticle) is one of the eligibility requirements for Google News inclusion, but it's not sufficient on its own. Google News also requires editorial standards, ownership transparency, regular publishing, and approval through the Publisher Center.
Why is my Article schema rejected?
Top causes: image below 1200 px wide, missing publisher.logo (must be 112 × 112 minimum), datePublished in wrong format (must be ISO 8601 like 2025-04-26T10:00:00Z), missing or generic author field, headline over 110 characters.