Article schema: complete guide

When to use: Blog posts, guides, and editorial content pages.

Required properties

headline — Article title
author — Person or Organization
datePublished — ISO-8601 date

Optional properties

image — Featured image URL
publisher — Organization with logo
dateModified — Last update date

Example JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Add JSON-LD to Your Site",
  "author": {
    "@type": "Person",
    "name": "Sam Writer"
  },
  "datePublished": "2026-04-01",
  "image": "https://www.example.com/hero.jpg",
  "publisher": {
    "@type": "Organization",
    "name": "Example Times",
    "logo": {
      "@type": "ImageObject",
      "url": "https://www.example.com/logo.png"
    }
  }
}

Validation tips

Use NewsArticle only for timely news that meets Google news policies
Keep headline similar to visible H1
Publisher logo should meet minimum size guidelines

Overview

Article helps search engines connect headline, author, and dates to your page. BlogPosting is a subtype—use it when it reflects the content.

Match dateModified to visible "updated" text when you maintain it.

Try the free Schema Generator →