NewsArticle Schema Generator — Get the Essentials Right

Generate valid NewsArticle JSON‑LD in minutes. Clarify headline, images, dates, authorship, and publisher identity with a crawlable logo.

Try the NewsArticle Generator

Why many news stories underperform

Pain points we solve

Headlines, dates, or images in snippets do not match the article.
Missing `publisher.logo` or low‑quality logos undermine brand presence.
Using NewsArticle for non‑news content creates confusion and maintenance issues.
Hand‑written JSON‑LD triggers validator warnings close to publish deadlines.

How SwiftSchema helps

Solution

The NewsArticle generator focuses on fields that matter for news: headline, high‑quality image(s), datePublished, dateModified, author, and publisher with a crawlable logo.

It outputs clean, copy‑ready JSON‑LD per story to keep your metadata consistent and aligned with publisher identity.

For non‑news content, use Article or BlogPosting to avoid misuse and reduce maintenance overhead.

How it works

Choose NewsArticle in the generator below.
Enter headline, at least one high‑quality image URL, and datePublished.
Add dateModified, author, and publisher with a crawlable logo URL.
Copy JSON or Script, paste into your article page template, and validate in the Rich Results Test.
Publish according to your editorial workflow; keep dates and metadata in sync on updates.

Generate NewsArticle JSON‑LD

Paste once per story. Validate. Ship.

What is NewsArticle structured data?

NewsArticle structured data clarifies your news story’s headline, hero images, publish/update dates, authorship, and publisher identity. It is intended for news publishers and helps search engines understand and present your content accurately across Google News, Discover, and other surfaces.

Eligibility & Status

NewsArticle is “limited”: news experiences (such as Top stories) depend on publisher eligibility, policy compliance, and manual reviews. Markup improves clarity but does not guarantee placement. Use NewsArticle only for timely news stories; choose Article or BlogPosting for evergreen or marketing content.

Why news markup matters

Trust and transparency: Accurate
publisher.logo
, author names, and timestamps build credibility with readers and search engines.
Distribution readiness: Consistent schema keeps AMP, canonical, and feed versions aligned, reducing validation errors during syndication.
Update signaling: Proper
dateModified
values tell search engines when you’ve updated a story.
Workflow efficiency: Templates ensure every story ships with compliant metadata, even during breaking news cycles.

Essential properties to include

headline
: Concise, descriptive, and matching the on-page H1/title.
image[]
: Array of high-resolution URLs (≥1200 px). Include multiple sizes for resilience.
datePublished
/
dateModified
: ISO 8601 timestamps with timezone offsets; update whenever you edit the story.
author
: Person entries with
name
and optional profile URLs.
publisher
: Organization name plus
logo
ImageObject (publicly accessible, high resolution).
mainEntityOfPage
: Reference the canonical URL to avoid duplication.
articleSection
,
keywords
,
inLanguage
: Clarify beat, tags, and locale.
Optional:
description
,
wordCount
,
speakable
, embedded
VideoObject
for multimedia stories.

Preparing newsroom content before generating schema

Finalize editorial metadata: Headline, dek, section, tags, embargo times.
Select hero imagery: Use licensed, high-quality photos and prepare fallbacks.
Verify author bios: Ensure author pages exist (ideally with Person schema).
Store publisher assets: Host official logos on a stable CDN with accessible URLs.
Document update policy: Decide how to display corrections/updates so
dateModified
aligns with visible notes.
Plan localization: Prep translated headlines and copy for international editions; manage hreflang/canonical settings.
QA checklist: Integrate schema validation into your CMS or CI pipeline prior to publication.

Implementation workflow inside SwiftSchema

Select NewsArticle in the generator.
Enter
headline
,
image[]
,
datePublished
,
dateModified
,
articleSection
,
keywords
,
inLanguage
, and canonical
url
.
Add
author
Person entries and
publisher
Organization (with
logo
ImageObject).
Include
mainEntityOfPage
,
description
, and optional
speakable
or
video
.
Export JSON-LD and embed it in your article template (canonical + AMP). Ensure structured data matches what users see.
Validate via Google’s Rich Results Test or Search Console’s Article testing tool before shipping.

Troubleshooting & QA

Headline mismatch: Align schema headline with H1 and
<title>
.
Low-quality logos/images: Use retina-ready, crawlable assets; avoid blocking with robots.txt.
Out-of-sync dates: Update
dateModified
whenever content changes and show update notes on the page.
Wrong content type: Don’t mark evergreen or promotional pieces as NewsArticle.
Missing
mainEntityOfPage
: Reference the canonical URL to reinforce ownership.
AMP discrepancies: Mirror schema across AMP and canonical pages to avoid validation errors.

Automate QA by running schema validation during staging builds. Fail builds if required fields are missing, images are too small, or dates fall outside expected ranges.

Maintenance and governance

Maintain a newsroom schema policy explaining when to use NewsArticle, how to document corrections, and how to handle multi-author stories.
Audit older stories periodically to ensure logos, author bios, and canonical URLs remain valid.
Update publisher branding in schema immediately after rebrands.
Keep
lastReviewed
metadata current for this guide and for internal documentation.

Common Errors & Fixes

Using NewsArticle for non-news: switch to Article/BlogPosting when appropriate.
Missing publisher logo: include a crawlable
ImageObject
with sufficient resolution.
Overlong headline: shorten to fit snippet limits.
Stale
dateModified
: update whenever you edit the story and annotate updates on page.
Missing
mainEntityOfPage
: add the canonical URL reference.

Required properties

headline
image
datePublished

Recommended properties

dateModified
author.name
publisher.name
publisher.logo
articleSection
mainEntityOfPage
inLanguage

Minimal NewsArticle JSON-LD

Validate

{
  "@context": "https://schema.org",
  "@type": "NewsArticle",
  "headline": "New guidance for structured data rollout",
  "image": [
    "https://example.com/images/structured-data-news.webp"
  ],
  "datePublished": "2025-05-10",
  "dateModified": "2025-05-11",
  "author": {
    "@type": "Person",
    "name": "Pat Reporter"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Example News",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.webp"
    }
  }
}

FAQs

Who should use NewsArticle?Show

Use NewsArticle for news publishers and news content. For non‑news content, use Article or BlogPosting instead.

Does NewsArticle markup put my site in Top stories?Show

No. Eligibility for Top stories and other news surfaces depends on additional publisher criteria and Google policies. Markup alone doesn’t guarantee inclusion.

What fields should I prioritize?Show

Provide a concise `headline`, at least one high‑quality `image`, `datePublished`, `author`, and `publisher` (with a crawlable logo).

Related types

Browse all schema types

SwiftSchema

Intuitive Schema Generation at Your Fingertips

NewsArticle Schema Generator — Get the Essentials Right

Why many news stories underperform

Pain points we solve

How SwiftSchema helps

Solution

How it works

How it works

What is NewsArticle structured data?

Eligibility & Status

Why news markup matters

Essential properties to include

Preparing newsroom content before generating schema

Implementation workflow inside SwiftSchema

Troubleshooting & QA

Maintenance and governance

Common Errors & Fixes

Required properties

Recommended properties

FAQs

Related types

References

Generate News Article schema

Schema Type

📰 News Article Schema Generator

Generated Schema