Article Structured Data: Fields, JSON-LD Examples & Best Practices

Article is one of the most commonly used structured data types, suitable for blog posts, news, guides, knowledge base articles, tutorials, and other article-style pages. Its goal is not to "gain rankings out of thin air," but to help Google more clearly understand this article's title, author, publication date, update date, main image, and page ownership, thereby more stably displaying title, date, and image information in search results.

What Pages Suit Article#

Google's Article documentation covers three common types: Article, NewsArticle, and BlogPosting. They all belong to article-like content but have slightly different semantics:

MagicSEO articles are long-maintained tutorials and guides, not news reports, so we uniformly use Article. If your site is a news media outlet and the page is a news report, then consider NewsArticle.

What Search Appearance Can It Improve#

Article markup helps Google more clearly understand page content and better use article title, image, date, and author information in search results, Google News, Google Assistant, and other scenarios. It is not a switch that "guarantees rich result cards," but rather a way to pass article core metadata to Google in machine-readable format.

How to Fill Recommended Fields#

Google's current Article documentation emphasizes: add recommended properties applicable to the page. In practice, prioritize at least these fields:

Among these, image is very important, but don't fake it just to fill the field. If the page has no real cover image, don't mark an image for now; systematically add cover images and visible image areas to articles later.

Complete JSON-LD Example#

Below is a common pattern for a tutorial article. In actual use, replace URL, title, date, image, and author with information truly visible on your page.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Website Speed Optimization: Core Web Vitals Practical Guide",
  "description": "Explains the meaning, detection methods, and common optimization techniques for LCP, INP, and CLS.",
  "image": [
    "https://example.com/images/site-speed-1x1.webp",
    "https://example.com/images/site-speed-4x3.webp",
    "https://example.com/images/site-speed-16x9.webp"
  ],
  "datePublished": "2026-06-24T09:00:00+08:00",
  "dateModified": "2026-06-24T09:00:00+08:00",
  "inLanguage": "en",
  "author": {
    "@type": "Person",
    "name": "John Doe",
    "url": "https://example.com/authors/john-doe"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Example SEO",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://example.com/technical-seo/site-speed.html"
  }
}
</script>

Publication Date and Update Date#

Date fields are where Article markup is most easily misused. The correct principles are simple:

• datePublished is the date the article was first published and should not change repeatedly with minor edits.
• dateModified is the date of the last substantive update, such as adding sections, rewriting conclusions, updating policies or data.
• Visible page date, structured data date, and sitemap lastmod should ideally maintain consistent definitions.

How to Mark Author#

The author field solves two questions: who wrote this article, and can users see this byline on the page?

If your site plans to strengthen E-E-A-T, consider creating author pages for individual authors and filling in the author page URL in Article structured data. This is more verifiable than a name alone.

How to Handle Image Fields#

Article's image is not any random image. It should be the article's actual main image or representative image and be crawlable by Google.

• Use absolute URLs for images; return 200 and not blocked by robots.txt.
• Images should be relevant to the article topic; avoid meaningless decorative images.
• Recommend preparing multiple ratios, e.g., 1:1, 4:3, 16:9, for cropping in different search scenarios.
• HTML should also display the corresponding image with reasonable alt, width, and height.

MagicSEO's current article pages don't have a unified cover image module, so this page's own Article markup doesn't fill in image. This isn't the ideal end state, but it better aligns with guidelines than marking a fake image users can't see. Later if article covers are added, both visible images and Article's image field should be completed together.

How This Page Demonstrates#

The page you're reading itself implements Article structured data. You can see three JSON-LD blocks from the page source: Article, BreadcrumbList, and FAQPage.

How to Validate#

Follow this process before and after launch:

1. Test URL or code snippet with Rich Results Test.
2. Confirm Article / NewsArticle / BlogPosting is detected.
3. Check if warnings come from missing recommended fields like image or author URL.
4. Use Search Console Rich Results Report to observe if site-wide article templates have batch errors.
5. If templates uniformly output Article, spot-check different categories, different authors, and no-image/with-image articles.

Common Mistakes#

Article Launch Checklist#

• Page is indeed article-style content
• @type selects the most appropriate among Article / BlogPosting / NewsArticle
• headline consistent with page main title
• author consistent with visible byline on page
• datePublished is first publication date
• dateModified changes only after substantive updates
• mainEntityOfPage points to canonical URL
• Fill in image when there is a real visible main image
• image is crawlable, relevant, preferably multiple ratios
• Validate with Rich Results Test without errors
• Monitor template-level issues in Search Console after launch

Frequently Asked Questions#

How do I choose between Article, NewsArticle, and BlogPosting?

Ordinary blog posts, guides, and knowledge base articles can use either Article or BlogPosting; news releases and time-sensitive news from media outlets are better suited for NewsArticle. The key is not to chase more advanced types but to match the type to the actual page content. MagicSEO tutorial articles use Article.

Is image required for Article structured data?

Google's current Article documentation emphasizes adding recommended properties applicable to the page rather than listing hard required fields. image is a very important recommended field, especially affecting image display in search results; if the page has no real, visible, and crawlable cover image, do not fabricate one just to fill the field.

Will Article markup get my page into Google News?

No. Article or NewsArticle markup helps Google better understand article title, author, date, and image, but it does not guarantee inclusion in Google News or Top stories. Google News eligibility also depends on site, content quality, policy compliance, and other news-related signals.

Can I use Organization when there is no individual author?

Yes. If an article is published on behalf of a team or organization, author can use Organization; if there is a clear individual byline, prioritize Person and provide the author page URL. Whether using Person or Organization, it must match the user-visible byline on the page.