Skip to content

Article Schema Markup Generator

Free

Generate Article JSON-LD structured data for blog posts and news articles. Add schema markup to qualify for Google top stories and rich search results.

article json-ld generatorblog post schema markupnewsarticle schema
All SEO Tools

Settings guide

Required fields:

  • ·headline: Your article title. Must be under 110 characters for Google News.
  • ·datePublished: Original publication date in ISO 8601 format: 2025-01-15T09:00:00+00:00
  • ·author: Author name and optionally their URL (author bio page or social profile)
  • ·publisher: Your organization name and logo URL

Recommended fields for rich result eligibility:

  • ·dateModified: Last update date — important for news content recency signals
  • ·image: Article feature image URL (must be at least 1200px wide for Top Stories)
  • ·description: Summary of the article (different from meta description)
  • ·mainEntityOfPage: Set to the canonical URL of the article

Article type selection:

  • ·Article: Generic editorial content
  • ·NewsArticle: Breaking news, time-sensitive reporting
  • ·BlogPosting: Opinion, personal, or blog-style content

Format comparison

Article schema vs Open Graph article type:

Open Graph's og:type="article" is a social media signal telling platforms how to categorize the content for sharing. Article JSON-LD is structured data for search engines, providing detailed metadata for rich results. Both use "article" conceptually but serve completely different systems — you need both on editorial content.

Article schema vs BreadcrumbList schema:

Article schema identifies the content itself. BreadcrumbList schema communicates the page's position in your site hierarchy. For best rich result eligibility, combine both on article pages: Article schema for content metadata, BreadcrumbList schema for site structure.

How it works

1

Choose article type

Select Article, NewsArticle, or BlogPosting based on your content type.

2

Fill in article metadata

Enter headline, author, publisher, publication date, modified date, and feature image URL.

3

Copy the JSON-LD block

Get the complete script tag to paste into your article page head or body.

4

Validate with Google

Test your markup in Google's Rich Results Test to confirm eligibility for article-related rich results.

About this format

Article structured data tells Google the author, publisher, publication date, modified date, and headline of your content — information that Google uses to determine eligibility for Top Stories carousels, Google News, Discover, and other rich result formats. Without it, Google has to infer these signals from your page content, which produces less reliable results.

This generator creates valid `Article`, `NewsArticle`, or `BlogPosting` JSON-LD markup. The three types are hierarchically related in the schema.org vocabulary: `NewsArticle` and `BlogPosting` are subtypes of `Article`. Use `NewsArticle` for time-sensitive news content, `BlogPosting` for blog content, and `Article` as the general-purpose type for editorial content that does not fit neatly into either category.

Key fields for Top Stories eligibility include: a verified organization publisher with a logo, the headline (identical to or closely matching the `<h1>`), `datePublished` and `dateModified` in ISO 8601 format, and an author entity. Google's Search Central documentation specifies all required and recommended properties — this generator covers all of them.

Frequently asked questions

What is Article schema markup and why does it matter?+
Article schema is JSON-LD structured data that explicitly tells Google the headline, author, publisher, and dates of your content. It makes your article eligible for enhanced search features including Top Stories carousels, Google News, and Discover. Without it, Google infers these fields from page content, which is less reliable and may exclude you from rich result eligibility.
What is the difference between Article, NewsArticle, and BlogPosting?+
All three are schema.org types for editorial content. Article is the generic parent type. NewsArticle is for time-sensitive news reporting — required for Google News eligibility. BlogPosting is for blog-style content including opinion, personal narratives, and commentary. Choose the most specific type that matches your content.
Does Article schema help with Top Stories in Google?+
Article schema is a prerequisite for Top Stories eligibility, but not a guarantee. Google also considers publisher authority, AMP status (recommended but not required), content freshness, and topical relevance. Valid Article or NewsArticle schema with a verified publisher entity improves your eligibility for the carousel.
What format should the datePublished field use?+
Use ISO 8601 format with timezone: 2025-01-15T09:00:00+00:00 for UTC, or 2025-01-15T09:00:00-05:00 for Eastern Time. Google requires the timezone offset to be included. Using only the date (2025-01-15) without the time is accepted but less precise. Update the dateModified field whenever you make significant edits — Google uses this timestamp as a freshness signal for news and timely content.
Does updating an article require updating the schema markup too?+
Yes. Update the dateModified field in your schema whenever you make significant edits to the article content. Google uses dateModified for freshness signals, especially for news content. An incorrect or stale dateModified that does not reflect actual updates sends misleading freshness signals.

Related tools and guides