Machine-Readable Infrastructure

Article Schema

Last reviewed:

Add to the <head> of each article page as <script type="application/ld+json">. Use Article as the default type for editorial content; use NewsArticle only for timely news on a news-eligible domain.

Google Rich Result variation

Google requires headline and strongly recommends image, datePublished, dateModified, and author. For Top Stories eligibility, image must be at least 1200×630px and the publisher needs News Publisher Center presence.

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "REQUIRED for Google rich result — match the visible H1, max 110 characters",
  "description": "RECOMMENDED — matches meta description, 1-2 sentences",
  "image": [
    "REQUIRED for Top Stories — absolute URL, minimum 1200x630px, aspect ratio >= 1.33"
  ],
  "datePublished": "REQUIRED — ISO 8601, e.g. 2026-03-28T09:00:00+00:00",
  "dateModified": "REQUIRED — ISO 8601; update on each substantive edit",
  "author": {
    "@type": "Person",
    "name": "REQUIRED — author display name",
    "url": "RECOMMENDED — author bio page URL"
  },
  "publisher": {
    "@type": "Organization",
    "name": "REQUIRED — publication or site name",
    "logo": {
      "@type": "ImageObject",
      "url": "REQUIRED — absolute URL to publisher logo, max 600x60px"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "REQUIRED — canonical URL of this article"
  }
}

NewsArticle variant

Use only for timely news content on a news-eligible domain — evergreen and opinion content should stay Article. Stricter image requirements and a compulsory freshness signal apply, and Top Stories requires News Publisher Center presence regardless of markup.

{
  "@context": "https://schema.org",
  "@type": "NewsArticle",
  "headline": "REQUIRED -- match H1; max 110 characters",
  "description": "RECOMMENDED -- matches meta description",
  "image": [
    "REQUIRED -- absolute URL; minimum 1200x630px, aspect ratio >= 1.33"
  ],
  "datePublished": "REQUIRED -- ISO 8601, e.g. 2026-03-28T09:00:00+00:00",
  "dateModified": "REQUIRED -- ISO 8601; update on each substantive edit",
  "author": {
    "@type": "Person",
    "@id": "RECOMMENDED -- canonical URL of author bio page",
    "name": "REQUIRED -- author full name",
    "url": "REQUIRED -- absolute URL of author bio page"
  },
  "publisher": {
    "@type": "Organization",
    "@id": "RECOMMENDED -- canonical home page URL with #organization fragment",
    "name": "REQUIRED -- publication name",
    "logo": {
      "@type": "ImageObject",
      "url": "REQUIRED -- absolute URL; 600x60px max, white or transparent background"
    }
  }
}

Field notes

  • dateModified is a freshness signal — omitting it or never updating it degrades AI Overview eligibility for time-sensitive content. It must reflect real editorial updates; inflating it to signal freshness is a trust-signal violation that can trigger manual review.
  • Top Stories eligibility requires image at minimum 1200×630px — smaller images disqualify the page — and News Publisher Center presence, which markup alone does not grant.
  • author.url pointing to a bio page with demonstrable expertise substantially strengthens E-E-A-T signals. For multi-author content, author can be an array.
  • Cross-link author.@id to a Person entity page and publisher.@id to the Organization block on the home page — see Nested Person / Author Schema.
  • Article schema does not produce a standalone visual rich result for most publishers on its own.