Skip to content

Article Schema Generator - JSON-LD for News & Blog Posts

Import existing JSON-LD

Paste JSON-LD or a full <script> tag. Matching fields fill the form; properties the form doesn't cover are kept in the output as they are.

Article Details

Dates

Author & Publisher

Google Search Preview
example.com
Article Title
Article description will appear here...
All Google requirements met

JSON-LD Output

What is Article schema?

Article schema is structured data that describes a news story, blog post, or other written article: its headline, images, publish and update dates, and author. It uses the schema.org Article type or its subtypes NewsArticle and BlogPosting. Google uses it to pick the right title, image, and date to show, and to understand who wrote the piece.

Google does not need Article markup to rank a page, and it can often work these details out on its own. The markup removes guesswork, especially about dates and authors. It matters most for publishers whose pages carry several dates (published, updated, event date) or bylines that are hard to parse.

Article schema example (JSON-LD)

A complete example you can adapt. Paste it into the page's HTML, or build your own with the generator above.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "NewsArticle",
  "headline": "City Council Approves Year-Round Ferry Service to Harbor Island",
  "image": [
    "https://example.com/photos/1x1/harbor-ferry.jpg",
    "https://example.com/photos/4x3/harbor-ferry.jpg",
    "https://example.com/photos/16x9/harbor-ferry.jpg"
  ],
  "datePublished": "2026-03-04T08:15:00-08:00",
  "dateModified": "2026-03-04T14:40:00-08:00",
  "author": [
    {
      "@type": "Person",
      "name": "Maya Okafor",
      "url": "https://example.com/staff/maya-okafor/"
    },
    {
      "@type": "Person",
      "name": "Daniel Reyes",
      "url": "https://example.com/staff/daniel-reyes/"
    }
  ],
  "publisher": {
    "@type": "Organization",
    "name": "Bayview Herald",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.png"
    }
  }
}
</script>

Which Google rich result does it enable?

Article markup does not unlock one specific rich result. It improves how your article appears in places Google already shows articles: the title, image, and date in regular results, the Top stories carousel, Google News, and Discover. Top stories eligibility depends far more on the content and Google's news policies than on markup.

Because there are no required properties, the markup will never fail validation for missing fields. What counts is that the dates, headline, and author are correct and match the page. If you want author information to carry weight, link each author to a profile page, which you can mark up with the ProfilePage schema generator.

Required and recommended properties

Property Status Notes
headline Recommended The article title. Long titles may be cut off.
image Recommended Several images at least 50,000 pixels in area, ideally in 16x9, 4x3, and 1x1 ratios.
datePublished Recommended ISO 8601 with a time zone, such as 2026-03-04T08:15:00-08:00.
dateModified Recommended Change it only when the content meaningfully changes.
author Recommended A Person or Organization. One entry per author.
author.name Recommended The name only, with no job title or "By" prefix.
author.url Recommended A page that identifies the author, such as a bio page or social profile.

Common Article schema mistakes

  • Putting two authors in one name, like "Maya Okafor and Daniel Reyes". Use an array with one Person per author.
  • Adding extras to author.name, such as "Posted by", a job title, or the publication name.
  • Updating dateModified on every deploy or comment. Google may stop trusting the date if it changes without real edits.
  • Using a logo or a stock icon as the article image. The image should represent the article itself.
  • Leaving out the time zone, which can make the date shift by a day for readers in other regions.

Article, NewsArticle or BlogPosting?

All three work the same way for Google, so the choice is about describing the page accurately. Use NewsArticle for news reporting, BlogPosting for blog posts, and Article for anything else, such as guides or opinion pieces on a company site. The generator outputs Article; change the @type value by hand if a subtype fits better.

Related Tools

Frequently Asked Questions

Does Article schema have required properties?
No. Google lists headline, image, datePublished, dateModified and author as recommended, and the markup won't fail validation if any are missing. Add the ones you can fill accurately.
Does Article markup get me into Top stories?
Not by itself. Top stories has no markup requirement, and AMP stopped being required in 2021. Eligibility depends on the content and on Google's news policies. The markup helps Google pick the right headline, image and date once a story is shown.
How do I add more than one author?
The form takes one author. For more, edit the output so author is an array with one Person per writer, as in the example above. Don't put two names in one name field.
When should dateModified change?
When the article's content changes in a way a reader would notice: a correction, new information, a rewritten section. Leave it alone for template changes, new comments or redeploys.
Where does the JSON-LD go?
Anywhere in the page HTML. The head is conventional, but Google also reads JSON-LD in the body, which is handy if your CMS only lets you add code to the post content.