XooCode(){

NewsArticle Schema Generator

Fill out a form. Get valid NewsArticle JSON-LD.

A form-driven builder for schema.org NewsArticle markup with a live JSON-LD preview that updates as you type. Handles the shared Article core (headline, description, image triple, three dates, author, publisher) plus NewsArticle-specific fields: dateline, printSection, printEdition, printPage, and printColumn in Full coverage mode. NewsArticle is the only Article subtype eligible for Google’s Top Stories carousel. Everything runs in your browser, nothing is sent to XooCode.

NewsArticle form

Title of the news article. Google truncates at 110 characters. 48/110

Summary of the news article. Google truncates at ~160 chars in the SERP.

Images (three aspect ratios)

Google's Article rich result requires images in three aspect ratios: 1:1 (1200x1200), 4:3 (1200x900), and 16:9 (1200x675). All three are recommended for full rich result eligibility.

Square. Minimum 1200x1200px.

Landscape. Minimum 1200x900px.

Widescreen. Minimum 1200x675px.

Canonical URL of the article page.

When the article was first published.

When the article was last updated.

Emits as nested Person. In Full mode you can use @id instead.

Emits as nested Organization.

Live JSON-LD output

schema.org/NewsArticle
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "NewsArticle",
  "headline": "XooCode Opens Flagship Store in Dunmore, Alberta",
  "description": "XooCode's first retail location opens its doors in Dunmore, Alberta, featuring the XooTee Classic line, the Jane Xoo archive corner, and the XooStructured product demo room.",
  "image": [
    "https://xoocode.com/media/dunmore-opening-1x1.jpg",
    "https://xoocode.com/media/dunmore-opening-4x3.jpg",
    "https://xoocode.com/media/dunmore-opening-16x9.jpg"
  ],
  "url": "https://xoocode.com/press/dunmore-store-opening",
  "datePublished": "2025-06-01",
  "dateModified": "2025-06-01",
  "author": {
    "@type": "Person",
    "name": "XooCode Press Team"
  },
  "publisher": {
    "@type": "Organization",
    "name": "XooCode Press"
  }
}
</script>

Updates as you type. Empty fields are omitted from the output. Click the copy icon above to copy the full <script> tag ready for pasting into your HTML head.

How to use the generator

The tool is a two-pane split: a form on the left, a live JSON-LD preview on the right. Type into any field and the preview updates immediately. When you’re done, click the copy icon in the preview header and paste the <script> block into your page’s <head> tag.

  1. 1

    Start from the seed

    Above the form there’s a Load example button. Click it and the form populates with the XooCode Dunmore store opening press release: headline, description, three image URLs, dates, author, publisher, and the DUNMORE, Alberta dateline. Use it to see what a fully-populated NewsArticle looks like before you clear and start your own.
  2. 2

    Pick coverage mode

    The Coverage dropdown has two settings. Essential shows headline, description, three image URLs, URL, datePublished, dateModified, author name, and publisher name (the minimum viable NewsArticle). Full keeps all of that and adds dateline, print metadata (printSection, printEdition, printPage, printColumn), dateCreated, alternativeHeadline, articleBody, wordCount, articleSection, keywords, inLanguage, mainEntityOfPage, @id author toggle, and paywall fields.
  3. 3

    Fill in the image triple

    Google requires at least one image and recommends three: a 1:1 square crop, a 4:3 standard crop, and a 16:9 widescreen crop. The form has dedicated URL fields for all three. Same pattern as Article, BlogPosting, and TechArticle. If you only have one image, put it in the 16:9 field and leave the others empty.
  4. 4

    Copy the output

    The preview pane shows the full <script type="application/ld+json"> wrapper with syntax highlighting. Click the copy icon to grab it and paste into your page head. Test it with Google’s Rich Results Test before publishing to catch value-level errors the form can’t detect (broken URLs, invalid dates, etc).

NewsArticle and the Top Stories carousel

Google’s Top Stories carousel appears near the top of search results for time-sensitive queries. It shows a card with headline, source name, and thumbnail image. The carousel only renders for pages marked up with NewsArticle structured data. Article and BlogPosting markup will not trigger it regardless of content quality or recency.

Beyond the markup itself, Top Stories eligibility requires several additional conditions. The site must be included in Google News, either through Google News Publisher Center registration or through Google’s general crawl inclusion. The content must be genuinely journalistic (reporting, investigation, editorial) rather than promotional or advertorial. And the article must have been published within the last few days; Top Stories is a recency feature that does not surface older content.

NewsArticle markup alone does not guarantee Top Stories placement. Google applies its own editorial and quality signals on top of the structural requirements. But the markup is a prerequisite: without it, the carousel cannot consider your page at all.

The dateline and print metadata

The dateline property records the geographic origin of the story. In traditional wire-service style this is the city and state/country where the reporter filed from, written in caps: “DUNMORE, Alberta” or “WASHINGTON, D.C.” or “LONDON”. The field is a plain text string, not a structured Place object.

The four print metadata fields (printSection, printEdition, printPage, printColumn) carry over from the newspaper tradition. They record which section of the paper the article appeared in, which edition, what page number, and which column. Most digital-only newsrooms skip these fields entirely, and that is perfectly fine. They exist for publications that still produce both a print edition and a digital counterpart.

The dateline, by contrast, is the one NewsArticle-specific field worth populating for every news article. It signals geographic relevance to Google and helps local news surface in location-based queries. If your newsroom covers a specific metro area, region, or country, include the dateline on every story.

The three-date pattern for news

NewsArticle inherits the same three date properties from Article: datePublished, dateModified, and dateCreated. The first two appear in Essential mode. The third is available in Full mode for newsrooms that distinguish between when a story was first drafted and when it went live.

For breaking news, the recommended pattern is straightforward. Set datePublished when the story goes live. Update dateModified on every correction, factual update, or material addition. Do not touch dateModified for cosmetic edits like typo fixes, formatting changes, or image swaps. Google’s systems treat frequent dateModified changes on news content as a potential manipulation signal more aggressively than on evergreen articles. A breaking story that shows ten dateModified timestamps in 24 hours looks suspicious; one that shows two or three (an initial publish and a correction) looks normal.

What this generator isn't

The NewsArticle Schema Generator is a tightly-scoped authoring tool. Knowing what it doesn’t try to do will save you time looking for features that were never part of the design.

It IS a full NewsArticle builder

Complete NewsArticle vocabulary: headline, description, image triple, three dates, author, publisher, dateline, print metadata, paywall fields, and every inherited Article property in Full mode.

It is NOT an Article builder

NewsArticle is a subtype of Article with extra fields. If your content is not news or journalism, use the Article Generator instead.

It IS Top Stories aware

The landing content explains Top Stories carousel eligibility, what qualifies, and why NewsArticle markup is a prerequisite. The builder itself emits the correct @type for carousel consideration.

It is NOT a Google News submission tool

Google News Publisher Center registration is separate from structured data. This tool builds the markup; it does not register your site with Google News.

It IS dateline and print aware

Full mode exposes dateline, printSection, printEdition, printPage, and printColumn. These are the fields that distinguish NewsArticle from its parent type.

It is NOT a Rich Results Test

Run the JSON-LD output through Google's Rich Results Test afterwards to catch value-level mistakes the form cannot detect (broken URLs, invalid dates, missing images).

Authoritative sources behind the NewsArticle vocabulary

The generator’s behaviour is sourced from primary documentation. These are the documents to consult when you need to verify anything the tool produces.

  • schema.org/NewsArticle. The canonical vocabulary definition. NewsArticle inherits from Article which inherits from CreativeWork which inherits from Thing, so the full property list extends well beyond the NewsArticle-specific section.
  • Google Article structured data documentation. Covers Article, NewsArticle, and BlogPosting in a single guide. The required and recommended property lists, Top Stories eligibility notes, and AMP-vs-non-AMP context all live here.
  • Google News Publisher Center. Where you register your site with Google News. This is a separate step from adding NewsArticle markup and is required for Top Stories carousel eligibility on most sites.
  • Google Rich Results Test. Run your generator output through this to confirm the markup is valid. It will preview the Article rich result card when the markup passes validation.