What Is Article Structured Data?
Article structured data is a block of schema.org markup, usually JSON-LD, that tells search engines a page is an article and states its headline, images, publication and update dates, and authors.
Google supports it on news, blog and sports article pages, and says it “can help Google understand more about the web page and show better title text, images, and date information for the article” in Google Search, Google News and other Google properties (Google Search Central, Article structured data, last updated September 8, 2026). For background on schema markup in general, see our explainer on schema and structured data.
What Article Markup Can and Cannot Do
Article markup describes a page; it does not promote it. Google's documentation is explicit on four points:
- No required properties. “There are no required properties; instead, add the properties that apply to your content.”
- Not needed for Top stories. Google: “there's no markup requirement to be eligible for Google News features like Top stories”. We look at what that means for coverage in does Article markup help coverage rank?
- No guaranteed display. “Google does not guarantee that features that consume structured data will show up in search results.” Google also says it does not guarantee a byline date will be shown (byline dates).
- Not a ranking lever in Google's documentation. Nothing in the Article guide says the markup improves ranking. Google's general guidelines add that a structured-data manual action removes rich-result eligibility but “doesn't affect how the page ranks in Google web search” (General structured data guidelines).
What it does do is state, in a form Google can parse, which page is an article, who wrote it and when it was published or changed.
How to Add Article Structured Data at a Glance
| Step | Action | Expected result |
|---|---|---|
| 1 | Choose Article, NewsArticle or BlogPosting | One type that matches the page |
| 2 | Add headline and image | The visible title and crawlable images at 16x9, 4x3 and 1x1 |
| 3 | Add datePublished and dateModified in ISO 8601 with a timezone | Dates that match the dates shown on the page |
| 4 | Add every author with @type, name and url | One author entry per visible byline |
| 5 | Add publisher and place the JSON-LD on the article page | A single valid script block in the page HTML |
| 6 | Test the code in the Rich Results Test | The Article item detected with no critical errors |
| 7 | Inspect the live URL in Search Console | The page is indexable and its structured data is detected |
Time: about 30 minutes for one page; a template or CMS change for a whole blog takes longer (our estimate). Tools: a text editor or CMS, the Rich Results Test, Google Search Console. Cost: none. Skill level: beginner to intermediate; editing a site-wide template needs developer access.
What You Need Before Starting
- Access to the page's
<head>or article template, or a CMS or SEO plugin that outputs structured data. - The article's final headline, a visible publication date and, if it has been updated, a visible “last updated” date.
- At least one representative image at a public URL, ideally in three aspect ratios.
- A profile or bio page URL for each author. Our guide to author and expert bylines covers why named authorship matters.
- Your organisation's name and home page URL for
publisher; if you already have Organization markup, its@id. - A verified Search Console property for Step 7.
Step 1: Choose Article, NewsArticle or BlogPosting
Pick the schema.org type that best describes the page. Google says Article objects “must be based on one of the following schema.org types: Article, NewsArticle, BlogPosting”, and supports the same properties for all three.
| Type | schema.org definition | Use it for |
|---|---|---|
NewsArticle | “A NewsArticle is an article whose content reports news, or provides background context and supporting materials for understanding the news” (schema.org) | News reports, press coverage you publish, newsroom posts |
BlogPosting | “A blog post”; it inherits Article's properties (schema.org) | Company blog posts, opinion and how-to posts |
Article | “An article, such as a news article or piece of investigative report”; the supertype of the other two (schema.org) | Reports, guides and articles that are neither news nor a blog post |
Why: Google's general guidelines say to “use the most specific applicable type”. Expected result: one type per article page. How to verify: the type describes what the visible page is. Common mistake: marking a product, category or home page as an article; Google says structured data “must be a true representation of the page content.”
Step 2: Add the Headline and Image Properties
Write headline as the article's title and image as one or more image URLs. Google says to consider “a concise title, as long titles may be truncated on some devices.”
Image rules from Google's Article documentation:
- Use images “relevant to the article, rather than logos or captions”, that “represent the marked up content.”
- Image URLs “must be crawlable and indexable”, in a format Google Images supports.
- “For best results”, provide multiple high-resolution images, “minimum of 50K pixels when multiplying width and height”, in 16x9, 4x3 and 1x1 aspect ratios. For example, 1200 × 675 is 810,000 pixels; 300 × 150 is 45,000 and falls short.
Total pixels (width × height) for example sizes we chose; only the 50,000 minimum is Google’s figure
Source for the minimum: Google Search Central, Article structured data (last updated September 8, 2026), image property: “minimum of 50K pixels when multiplying width and height”. Example sizes and totals: Media Morpheus arithmetic.
The image sizes are illustrations, not Google recommendations; each value is width multiplied by height. Google gives the minimum “for best results”, in 16x9, 4x3 and 1x1 ratios.
Expected result: a headline that matches the visible title and an image array of absolute URLs. How to verify: open each image URL in a private window, and check it is not blocked by robots.txt. Common mistake: using the site logo as the article image.
Step 3: Add datePublished and dateModified
Add datePublished for first publication and dateModified for the most recent change, both in ISO 8601 format with a timezone, for example 2026-10-07T09:00:00-04:00. Google recommends the timezone; without it, Google defaults to the timezone used by Googlebot.
Rules from Google's byline dates guidance:
- Show the date on the page too, labelled with text such as “Published” or “Last updated”.
- Keep visible and structured dates consistent: they must match, though time and timezone can be left out of the visible date.
- “Don't specify future dates, or the date of the action described on the page.” The date is the page's, not the event's.
- If Google picks the wrong date, consider “removing some or all other dates that appear on the page.”
Expected result: two ISO 8601 values that match the visible dates. How to verify: compare the markup with the byline on the rendered page. Common mistake: updating dateModified on every deploy without changing the article. Google's Rich Results Test does not warn about these two properties, so it will not catch it.
Step 4: Mark Up Every Author with name, url and @type
Add an author entry for each person or organisation shown as an author on the page, following Google's author markup best practices:
- Include all authors presented on the page.
- One author per entry. Use an array of separate objects; don't write
"name": "Willow Lane, Regula Felix". - Use
@typeandurl(orsameAs). Google “strongly recommend[s]” both.author.urlis “a web page that uniquely identifies the author”, such as a bio or “about me” page; if it is an internal profile page, Google recommends marking it up with profile page structured data. - Name only in
name. No publisher name, job title, honorifics or words like “posted by”. UsejobTitle,honorificPrefixorpublisherfor those. - Right type.
Personfor people,Organizationfor organisations; neverThing.
Expected result: the markup's authors match the visible byline exactly. How to verify: count bylines on the page and author objects in the code. Common mistake: naming a person in the byline but the company as author in markup. Our explainer do author bylines affect credibility signals? covers what Google says bylines do and do not do.
Step 5: Add the Publisher and Place the JSON-LD on the Page
Add a publisher object for your organisation, then put the complete JSON-LD block in a <script type="application/ld+json"> element on the article page itself. Google recommends JSON-LD among its three supported formats, and says markup belongs “on the page that it describes” (General structured data guidelines). publisher is not in Google's Article property table, but Google's author best practices name it as the place for the publisher's name. If you have Organization markup, reference it by @id; our guide on adding Organization schema markup sets that up.
A complete example for a company blog post:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"@id": "https://example.com/blog/q3-results#article",
"mainEntityOfPage": "https://example.com/blog/q3-results",
"headline": "What Our Q3 Customer Survey Found",
"image": [
"https://example.com/images/q3-survey-1x1.jpg",
"https://example.com/images/q3-survey-4x3.jpg",
"https://example.com/images/q3-survey-16x9.jpg"
],
"datePublished": "2026-10-07T09:00:00-04:00",
"dateModified": "2026-10-07T09:00:00-04:00",
"author": [
{
"@type": "Person",
"name": "Willow Lane",
"jobTitle": "Head of Research",
"url": "https://example.com/team/willow-lane"
}
],
"publisher": {
"@type": "Organization",
"@id": "https://example.com/#organization",
"name": "Example Company",
"url": "https://example.com/"
}
}
</script>
For a news story, change "@type" to "NewsArticle". For several authors, add one object per author to the author array.
Expected result: the script block appears in the page source, or in the rendered HTML if your site injects it with JavaScript, which Google says it can read. How to verify: view the page source and find the block. Common mistake: leaving comments in the JSON. The Rich Results Test ignores them, but Google says comments are not supported by the JSON-LD standard and “might result in errors in actual usage” (Rich Results Test help).
Step 6: Test the Markup in the Rich Results Test
Run the page through the Rich Results Test. Before publishing, choose Code instead of URL, paste the HTML and click Run test; after publishing, enter the full URL (Rich Results Test help).
What to read: the detected structured data section lists every item found, “whether good, with warnings or errors, or unparseable”; expand an item and click an issue to jump to the code. Google's Article guide says to fix critical errors and to consider fixing non-critical issues, which are not required for rich-result eligibility. For checks beyond Google's features, the Schema Markup Validator tests general schema.org syntax.
Expected result: an Article item detected with no critical errors. How to verify: the tool shows the page “crawled successfully” when testing a URL. Common mistake: testing a page behind a login or firewall; Google says all page resources must be reachable by an anonymous user.
Step 7: Inspect the Live URL in Search Console
Open the URL Inspection tool in Search Console, enter the article URL and click Test live URL. Google's Article guide recommends deploying a few pages first and using this tool “to test how Google sees the page”, making sure the page is not blocked by robots.txt, noindex or a login.
What to check: the page is indexable, and the Enhancements section shows the structured data Google found. If the page looks right, you can click Request indexing; for many pages, Google recommends submitting a sitemap instead (see how to submit a sitemap to Google and Bing).
Expected result: an indexable page with its structured data detected. How to verify: re-inspect after Google recrawls; Google says it “may take several days after publishing a page for Google to find and crawl it.” Common mistake: inspecting a URL outside your property; for those, use the Rich Results Test.
How to Verify It Worked
- Rich Results Test: the URL test detects the Article item with no critical errors.
- URL Inspection: the live test reports the page as indexable and lists the structured data under Enhancements.
- Page source: one
application/ld+jsonblock with the right@type, and dates and authors that match the visible byline. - Search Console reports: no new entries for the page in the Unparsable structured data report (it appears only if Google finds structured data it cannot parse), and no structured-data issue in Manual Actions.
- Search results: optional, and not proof either way. Google may or may not show the title, image or date you marked up.
How to Choose a Markup Method
| Situation | Recommended method | Why |
|---|---|---|
| Hand-built or static site | JSON-LD in the article template's <head> | Google's recommended format; kept separate from visible HTML |
| CMS with an SEO plugin that outputs Article markup | Configure the plugin; don't add a second block | Avoids two conflicting Article items |
| Existing microdata or RDFa that validates | Keep it | Google says all three formats “are equally fine” if valid |
| JavaScript-rendered site | JSON-LD injected at render, then test the live URL | Google says it can read dynamically injected JSON-LD |
| Paywalled or registration-only articles | Article markup plus paywalled-content markup | Google's technical guidelines point to it for subscription content |
| Multi-page articles | Canonical to each page or a view-all page | Google says not to canonicalise to page 1 of a series |
Common Problems and Fixes
| Problem | Likely cause | Fix |
|---|---|---|
| Rich Results Test finds no structured data | Script missing from the served or rendered HTML, or a JSON syntax error | Check the source; validate the JSON; remove trailing commas and comments |
| Item listed as unparseable | Malformed JSON-LD | Follow the error to the line in the code explorer and fix it |
| “Crawl failed” on a URL test | robots.txt block, noindex, login or firewall | Allow Googlebot; test the code instead while fixing access |
| Google shows the wrong date | Visible and structured dates differ, or other dates on the page compete | Make them match; remove extra dates near the byline |
| Image not used | Image blocked, too small, or a logo | Use crawlable images over 50,000 pixels in three ratios |
| Two Article items on one page | Theme or plugin and a manual block both output markup | Keep one source of Article markup |
| Markup valid but nothing changes in Search | Google does not guarantee features; recrawl takes time | Wait for recrawl; review the quality guidelines; expect no ranking change |
What Not to Do
- Do not mark up content readers can't see. Consequence: Google's quality guidelines forbid it, and violations can block rich results or be treated as spam. Correction: describe only what is on the page.
- Do not put several authors in one
name. Consequence: Google cannot tell the authors apart. Correction: one object per author. - Do not set future dates or the date of the event described. Consequence: Google's byline-date guidance is broken. Correction: use the page's publication and update dates.
- Do not impersonate a person or organisation. Consequence: Google forbids misrepresenting “ownership, affiliation, or primary purpose”, and can apply a manual action. Correction: list only real authors and your own organisation as publisher.
- Do not block the page from Googlebot. Consequence: Google cannot read the markup. Correction: no robots.txt block,
noindexor login on marked-up pages. - Do not add markup expecting higher rankings. Consequence: misplaced effort. Correction: treat it as accurate labelling, alongside good content and clear bylines.
Frequently Asked Questions
Is Article structured data required to appear in Google News or Top stories?
No. Google says there is no markup requirement to be eligible for Google News features like Top stories. Article markup tells Google more explicitly what the content is, who wrote it and what it is called.
Does Article schema improve rankings?
Google's Article documentation does not say it does. Google describes it as helping it understand the page and show better title, image and date information, and says it does not guarantee that structured-data features will appear.
Should a company blog use BlogPosting or Article?
Either is supported by Google. Google's general guidelines say to use the most specific applicable schema.org type, so BlogPosting fits a blog post and NewsArticle fits news reporting.
Is dateModified required?
No. Google lists it as recommended and says the Rich Results Test does not warn when it is missing. Add it when the article has been updated, and match it to the visible “last updated” date.
Can author be an organisation instead of a person?
Yes. Google accepts Person or Organization for author and says to use Organization for organisations and Person for people, linking an organisation author to its home page.
What image size does Google recommend for Article markup?
Google recommends multiple high-resolution images of at least 50,000 pixels when width is multiplied by height, in 16x9, 4x3 and 1x1 aspect ratios, using images relevant to the article rather than logos.
Can I add Article markup with JavaScript or Google Tag Manager?
Google says it can read JSON-LD that is dynamically injected into the page. Test the live URL in the Rich Results Test or URL Inspection to confirm Google sees the rendered markup.
Do I still need Article markup if my SEO plugin adds schema?
Check what the plugin outputs in the Rich Results Test first. If it already produces an Article item with your headline, dates and authors, configure it rather than adding a second block.
Why does Google show a different date from the one in my markup?
Google says it looks at several factors to estimate a byline date. Make the visible and structured dates match, avoid future dates, and consider removing other dates on the page.
Sources and Methodology
This guide is built from Google Search Central documentation, Search Console Help and schema.org type definitions, read on October 7, 2026. We checked that the JSON-LD example parses as valid JSON; we did not run it through the Rich Results Test or deploy it, so we make no claim about how Google displays it. The time estimates are ours. Google's documentation does not say Article markup affects ranking, and we found no Google statement that it does. Interface labels are quoted from Google's help pages on that date and may change.
- official Google Search Central, Article (Article, NewsArticle, BlogPosting) structured data, last updated September 8, 2026. Types, recommended properties, image rules, author best practices, troubleshooting. Read October 7, 2026.
- official Google Search Central, General structured data guidelines, last updated July 10, 2026. Read October 7, 2026.
- official Google Search Central, Introduction to structured data markup in Google Search. Formats and JSON-LD. Read October 7, 2026.
- official Google Search Central, Influence your byline dates in Google Search. Read October 7, 2026.
- official Search Console Help, Rich Results Test. Read October 7, 2026.
- official Search Console Help, URL Inspection tool. Read October 7, 2026.
- official Search Console Help, Unparsable structured data report. Read October 7, 2026.
- official schema.org, Article, NewsArticle and BlogPosting. Read October 7, 2026.