Article Schema Generator

Build Article, NewsArticle, or BlogPosting JSON-LD. Google lists no required properties; the form tracks the headline, images, dates, and author it recommends.

JSON-LD

Rich Results Test ↗

Google does not list required properties for this type. Recommended fields still make the markup easier to understand.

Recommended fields still open

  • Add a headline. Google lists no required Article properties, and the headline is the one it recommends first.
  • Add one or more image URLs that show the article, not a logo. Google recommends 16:9, 4:3, and 1:1.
  • Add datePublished in ISO 8601, with a timezone if you know it.
  • Add dateModified if the article has been updated.
  • Add the author's name. Google recommends a Person or Organization, not a combined byline.
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article"
}
</script>

Paste the script into the page HTML, in the head or before </body>. Then open Google's Rich Results Test, choose the code tab, and paste it again.

Article on schema.org · Google's documentation

Want the marketing handled too?

SEOchat publishes pages about your business, keeps your Google listing active, and reports results every week. Starter is $99/month. Growth is $179/month. Cancel anytime.

A business name and website you already typed are carried into checkout. They do not change the price.

What Article markup is for

Article markup tells Google which text is the headline, which pictures belong to the story, when it was published, and who wrote it. Google's current Article documentation lists those as recommended, not required. There is no special rich result you unlock by filling every box. The benefit is fewer guesses about the title, the date, and the byline.

Use images of the story. A logo is a weak image for an article. Google recommends large images in 16:9, 4:3, and 1:1 when you have them. Dates should be ISO 8601. Add a timezone when you know it. If you leave it off, Google says it will assume the timezone Googlebot uses.

How to add this markup

  1. Confirm the page is one article, not a list of posts.
  2. Enter the headline readers see, the dates, and one author.
  3. There is no required-field list to clear. Fill the recommended lines that match the page.
  4. Copy the script into that article's HTML.
  5. Test it in Google's Rich Results Test. Warnings there about recommended fields are worth reading. They are not the same as a penalty.

The author can also have a person page. The publisher can have organization markup on the homepage. A list of questions at the bottom of the article is a separate FAQ, and only if those questions are visible.

Questions

Does an article need schema to appear in Google News?

No. Google says there is no markup requirement for News features such as Top stories. Article markup tells Google the headline, the images, the dates, and the author more explicitly. It does not by itself put a story in Top stories.

Which type should I pick?

Article is the general type. NewsArticle fits reporting. BlogPosting fits a blog post. Use the type that describes the page, not the one that sounds more important.

What does Google recommend?

A headline, one or more images of the story, datePublished, dateModified when you update it, and an author that is a Person or an Organization with a name and a URL. There is no required list.

How should multiple authors be marked up?

Each author gets their own object in an array. Do not put “Ada Lovelace, Grace Hopper” in one name. This form writes one author. Duplicate the object in the JSON if the page shows more than one.

What belongs in the author name?

Only the name. Job title, “Dr.”, and “posted by” go in their own properties, or they stay off the name. The publisher is a separate organization.

More free tools

See all tools