Article Schema Generator

Generate a valid schema.org/Article (or NewsArticle / BlogPosting) JSON-LD block that helps your content qualify for Google Top Stories — the news-article carousel that appears prominently for trending topics. Enter the headline, author, publisher, and dates; the generator warns you if the headline exceeds Google's 110-character limit and builds a clean script block ready for your <head>.

Author
Publisher

How to use the Article Schema Generator

Select the article type that most accurately describes your content, fill in the required fields (marked with an asterisk), and click Generate. The output updates live as you type.

  1. Article type — Use Article for evergreen content; NewsArticle for time-sensitive news or journalism; BlogPosting for blog posts. The type affects how Google classifies the content and which rich-result features it is eligible for.
  2. Headline — must match the <h1> on the page. Google enforces a 110-character limit; the generator warns you if you exceed it. Do not use a title different from the visible page heading.
  3. Images — enter one URL per line. Google requires at least one image; multiple images let Google choose the best one for different surfaces. Minimum width is 1200 px; 16:9 preferred for Top Stories.
  4. datePublished / dateModified — required for NewsArticle. Use the exact publication time including hours and minutes for news content; Google uses this for freshness ranking.
  5. Publisher logo — must be a rectangular logo (up to 600×60 px) on a white or transparent background. Google displays it in the Top Stories carousel alongside the publication name.

What is Article schema and which Google rich results does it power?

Article schema (schema.org/Article and its subtypes NewsArticle and BlogPosting) signals to Google that a page is a piece of editorial content with a defined author, publication date, and publisher. The primary rich-result it powers is Google Top Stories — a horizontally scrollable carousel that appears above organic results for news-related queries, typically labelled "Top stories" or "In the news." Top Stories positions are highly competitive and can drive significant traffic spikes for trending topics. For AMP pages, Article schema was historically mandatory; for non-AMP pages it is strongly recommended but not required to appear in Top Stories.

Google distinguishes the three subtypes: Article is the most generic and suitable for tutorials, guides, or opinion pieces. NewsArticle is intended for journalism, press releases, and real-time reporting — Google may apply more freshness weighting here. BlogPosting suits personal or company blog content and is treated as less time-sensitive than news. Required properties across all three are headline, image, datePublished, and publisher. For Google Top Stories specifically, a Google News inclusion is also recommended (separate from schema).

A key gotcha: the headline property must exactly match the visible <h1> text on the page. Mismatches between structured data and visible content are one of the most common reasons Google demotes or rejects an article rich result. Similarly, the publisher logo must be a clear, legible logo — not a photograph or a hero image — to pass Google's logo guidelines.

Common use cases

  • Online newspapers and news sites — add NewsArticle schema to every article page to qualify for Google Top Stories placement, which often drives more traffic than organic position #1 for breaking topics.
  • Company blogs — use BlogPosting schema with accurate author and publisher data to improve byline visibility in search results and strengthen E-E-A-T signals (Experience, Expertise, Authority, Trust).
  • Content marketing agencies — generate and template Article schema across client sites to ensure consistent structured data quality without manual per-article effort.
  • Multi-author publications — include author URL pointing to an author bio page; this helps Google build an entity understanding of the author and associate their articles over time.
  • Tutorial and how-to sites — even for non-news content, Article schema improves crawler understanding of publication dates, helping Google identify content that has been recently updated vs. stale.

Frequently asked questions

Does my article need to be AMP to use Article schema?
No. Google dropped the AMP requirement for Top Stories eligibility in 2021. Standard (non-AMP) pages with Article schema, fast Core Web Vitals, and Google News inclusion are now eligible. AMP is optional.

What is the difference between NewsArticle and Article?
NewsArticle signals to Google that the content is journalism — time-sensitive, factual, produced by a recognized news organization. Article is more generic. Use NewsArticle for reporting and breaking news; use BlogPosting for opinion, tutorials, and evergreen content.

Why does Google say my headline is too long?
Google enforces a 110-character limit on the headline property. Longer headlines may be truncated or rejected during structured data processing. The generator shows a warning at 110 characters — shorten the headline or move detail into the description field.

Do I need separate Article schema for each article on a listing/index page?
No — Article schema belongs on the individual article page, not on listing pages. For listing pages, consider ItemList schema that links to each article's URL.

What logo dimensions does Google require for the publisher logo?
The logo must be a rectangle, at most 600×60 px, on a white or transparent background. Wider logos are preferred (e.g. 300×50 works; 60×60 is technically valid but less recognizable). Avoid animated or color-background logos.