How to add Article schema (JSON-LD) to any page

To add Article schema, drop a JSON-LD <script type="application/ld+json"> block into your page's server-rendered HTML with the article's headline, image, dates, author, and publisher. It takes a few minutes, helps Google understand and attribute your content, and gives AI systems clean metadata to cite you correctly. Here's the exact markup and the fields that matter.

What Article schema is for

Structured data translates your page into a vocabulary machines understand. Article schema specifically says "this page is an article, here's its headline, who wrote it, when, and the image that represents it." Search engines use that for correct attribution and eligibility for certain result features; AI systems use it as a reliable source of the metadata they'd otherwise have to guess at — author, date, publication — which matters when they decide whether and how to cite you.

The markup

Here's a complete, valid Article JSON-LD block:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to add Article schema to any page",
  "image": "https://yoursite.com/article-image.jpg",
  "datePublished": "2026-07-18",
  "dateModified": "2026-07-18",
  "author": {
    "@type": "Person",
    "name": "Jane Doe",
    "url": "https://yoursite.com/authors/jane"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Your Site",
    "logo": {
      "@type": "ImageObject",
      "url": "https://yoursite.com/logo.png"
    }
  }
}
</script>

Replace the values with your real data and you're done. JSON-LD is Google's preferred format precisely because it sits in one block and doesn't tangle with your HTML markup.

The fields that matter

• headline — the article title (keep it under ~110 characters).
• image — an absolute URL; a large, representative image helps.
• datePublished / dateModified — real ISO dates. dateModified is the freshness signal AI and search both weigh, so update it when you genuinely revise the piece.
• author — a Person (or Organization) with a name, ideally a url to an author page. Author signals matter increasingly for trust.
• publisher — an Organization with name and logo.

Google's strictly required set is small, but filling in the recommended fields is what makes the markup genuinely useful rather than just valid.

Article, BlogPosting, or NewsArticle?

These are subtypes with identical fields — use the most specific one that fits:

• NewsArticle — time-sensitive news.
• BlogPosting — blog posts and evergreen articles (this is the right pick for most content sites).
• Article — the general fallback when neither fits.

Pick one, keep the properties the same, don't overthink it.

The rules that keep it valid

1. Server-render it. The JSON-LD must be in the raw HTML response. If a tag manager or client script injects it, crawlers and validators reading raw HTML won't see it — the same JavaScript blind spot that affects most AI crawlers.
2. Match the visible page. The headline, author, and dates in your schema must match what's actually on the page. Mismatches are a common cause of "structured data doesn't match content" warnings.
3. Use absolute URLs for image, logo, and author.url.
4. Keep dates honest. Don't bump dateModified without real changes — it's a trust signal, not a hack.

Generate it instead of hand-writing JSON

Hand-writing JSON-LD invites typos — a missing brace or comma silently breaks the whole block. Our free Article & HowTo Schema Generator builds valid Article (or HowTo) JSON-LD from a simple form: fill in the headline, author, dates, and image, and copy the output straight into your page. No JSON syntax to get wrong.

Validate before you ship

After adding the markup, confirm it parses and has the fields it should. Our free Schema Validator checks your JSON-LD (paste it, or point it at a live URL) against the required and recommended fields for each type and flags problems. Cross-check with Google's Rich Results Test too — the two answer different questions (validity vs. search-feature eligibility) and are worth running together. For the wider picture on why this markup matters for AI, see structured data for AI.

Bottom line

Add a JSON-LD Article block with headline, image, real dates, author, and publisher; put it in server-rendered HTML; keep it matching the visible page. Generate it to avoid syntax errors, validate it before publishing, and your content becomes properly legible — and citable — to both search engines and AI.