Article schema markup: example, recommended fields and WordPress setup

Article schema is JSON-LD that states the basic facts of an editorial page: its headline, who wrote it, when it was published and last updated, and which images represent it. Google lists no required properties for Article, only recommended ones, so the job is to fill those accurately rather than to hit a checklist.

Don't expect a visible reward in search. Article markup rarely changes how a listing looks. Add it anyway, to every post, because it is the clearest machine-readable statement of authorship and freshness you can give both search engines and AI assistants. See our schema markup guide for where it fits among the types that still pay off.

JSON-LD example

Copy this into a <script type="application/ld+json"> tag and replace the values with your own.

json
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "How to Repot a Fiddle Leaf Fig Without Shocking It",
  "image": [
    "https://example.com/images/fiddle-leaf-16x9.jpg",
    "https://example.com/images/fiddle-leaf-4x3.jpg",
    "https://example.com/images/fiddle-leaf-1x1.jpg"
  ],
  "datePublished": "2026-03-04T08:00:00-05:00",
  "dateModified": "2026-08-19T14:30:00-04:00",
  "author": [
    {
      "@type": "Person",
      "name": "Maya Lindqvist",
      "url": "https://example.com/authors/maya-lindqvist"
    }
  ],
  "publisher": {
    "@type": "Organization",
    "name": "Greenroom Journal",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.png"
    }
  },
  "mainEntityOfPage": "https://example.com/repot-fiddle-leaf-fig"
}

Properties

PropertyStatusWhat it is
headlineRecommendedThe article title. Keep it concise; long headlines may be truncated in some displays.
authorRecommendedA Person or Organization with a name. Add url pointing to an author page. List each author separately.
datePublishedRecommendedFirst publication date and time in ISO 8601, ideally with a time zone offset.
dateModifiedRecommendedDate of the last meaningful edit, in ISO 8601.
imageRecommendedOne or more image URLs. Google recommends high-resolution images in 16x9, 4x3 and 1x1 ratios.
publisherRecommendedThe Organization that publishes the article, with name and logo.
mainEntityOfPageRecommendedThe canonical URL of the page the article lives on.

Article, BlogPosting or NewsArticle?

All three are valid for Google's Article feature and take the same properties. Pick the most specific one that is true:

  • BlogPosting for posts on a blog.
  • NewsArticle for news reporting on a news site.
  • Article for everything else editorial: guides, essays, long-form reference pages.

The choice matters less than the accuracy of the fields inside it. Do not use Article on product pages, category archives or your homepage; those have better-fitting types such as Product or WebSite.

Add it in WordPress

By hand. Print a <script type="application/ld+json"> block from your theme's wp_head hook, filling headline, dates and author from the post. It works, but you have to maintain it and keep it from duplicating markup from your SEO plugin.

With Hydrogen SEO. Set Article as the site-wide type for posts on the Schema screen, then use smart tags (type @ in a field) such as the post title, author and publish and modified dates so every post gets correct, page-specific values with no per-post editing. Individual posts can switch to a more specific type in the SEO Settings sheet. The JSON-LD is rendered server-side, so crawlers see it without running JavaScript. Developers can adjust the output, for example to add a publisher logo, with the hydrogen_seo_schema_markup filter.

One-off markup. To hand-write a block for a static page, the free schema generator in the Hydrogen SEO app at /seo/schema-generator builds Article JSON-LD from a short form, instantly and without credits.

Common mistakes

  • Author as a plain string with extra text. Use "name": "Maya Lindqvist", not "By Maya Lindqvist, Editor". Put only the name in name, and use a separate object for each author.
  • Organization as author when a person wrote it. Use Person for people; use Organization only when the article genuinely has no individual author.
  • Faking freshness. Bumping dateModified without changing the content is misleading. Update it when you make a real edit.
  • Dates without time zones. A bare date works, but a full timestamp with an offset removes ambiguity.
  • Tiny or missing images. Use large, crawlable images that actually appear on the page.
  • Two plugins printing Article. Duplicate blocks with different values confuse parsers. Keep one source of schema. More in invalid structured data.

Test it

Paste your draft Article markup into the JSON-LD validator to catch missing properties early; the published page still needs a pass through Google's Rich Results Test. Since Article has no required fields, the Rich Results Test mostly reports warnings for missing recommended properties. Fix the ones you have real data for. After rollout, watch Search Console for structured data issues across all posts, and run a free SEO audit to spot posts with no structured data.

Common questions

Is Article schema required for Top stories?

No. Google has said Top stories does not require Article markup. The markup helps Google understand the headline, dates, images and author, which it uses across its results.

Should I use Article or BlogPosting for a WordPress blog?

BlogPosting is the more specific type for blog posts and is fully supported by Google's Article feature. Article is also fine. Either works if the properties are accurate.

Does Article schema improve rankings?

Not directly. Structured data is not a ranking factor on its own. It makes the page easier for search engines and AI systems to interpret and attribute.

Do I need both datePublished and dateModified?

Both are recommended. Include datePublished always, and include dateModified when the post has been meaningfully updated since publication.