Article Schema Best Practices and Mistakes to Avoid

The best Article schema mirrors the visible page exactly, uses the most specific type, keeps dateModified honest, and points to crawlable 1200 px+ images — deviate from those and Google either ignores the markup or flags a warning. Structured data is easy to generate and just as easy to get subtly wrong in ways that silently cost you rich treatment in Search and Discover. This guide covers the practices that keep your Article JSON-LD valid and effective.

Make the markup match what readers see

Google's core rule is that structured data must reflect visible content. The most common violation is a headline in the schema that doesn't match the on-page H1 — often because someone pastes the SEO title tag instead. Keep them aligned:

• Headline: use the article's visible H1, not the meta title, and keep it under ~110 characters.
• Author: name the real byline shown on the page, modelled as a Person (or Organization for staff-written pieces).
• Image: reference an image that actually appears with the article, not a stock placeholder.

Markup that describes content readers can't see is the fastest route to a manual action or ignored rich results.

Pick the most specific type

Article, NewsArticle and BlogPosting are treated similarly, but specificity is best practice and costs nothing. Choosing wrongly won't break anything, but choosing well signals intent clearly.

Type	Use for	Avoid for
NewsArticle	Journalistic, time-sensitive news	Evergreen how-to guides
BlogPosting	Blog posts, opinion, tutorials	Breaking news
Article	General fallback when unsure	When a specific type clearly fits

Handle dates honestly

datePublished is the original go-live date; dateModified is the last significant update. Two mistakes to avoid: bumping dateModified without actually changing the content (against Google's guidelines and detectable, since Google compares markup to the page), and omitting dateModified after a real update, which loses the freshness signal. Set both from real dates, and only touch dateModified when you've meaningfully revised the piece. The tool emits ISO 8601 dates automatically, so you don't hand-format and risk an invalid timestamp.

Get images and publisher details right

Image errors are a leading cause of ineligibility. Best practices:

• Resolution: supply images at least 1200 px wide; low-res images can disqualify rich treatment.
• Aspect ratios: where possible provide 16:9, 4:3 and 1:1 so Google picks per surface.
• Crawlability: the image URL must be absolute and not blocked by robots.txt — a blocked image is invisible to Google.
• Publisher logo: include the publisher name and a logo ImageObject; the tool wraps it correctly so you don't malform the nested object.

Because the generator omits empty fields and pretty-prints the block, you avoid stray null values and can eyeball the output before pasting. Everything runs in your browser, so unpublished drafts and internal URLs never leave your machine. After pasting, validate with Google's Rich Results Test to catch anything site-specific.

Try the Article Schema Generator — free and 100% in your browser.

FAQ

Does the schema headline have to match my title tag?

No — it should match the article's visible H1, which often differs from the SEO title tag. Using the title tag instead of the on-page headline is a frequent validation warning.

Can I update dateModified to look fresh without editing the post?

You shouldn't. Google's guidelines require dateModified to reflect a genuine content change, and Google can compare the markup against the actual page. Only update it after a real revision.

What's the most common Article schema error?

Mismatched or missing required fields — usually a headline that doesn't match the page, or an image that's too small or blocked by robots.txt. Aligning markup to visible content and supplying a crawlable 1200 px+ image fixes most of them.

Do I need both author and publisher?

Provide both when you can: author identifies who wrote it (Person or Organization), and publisher with a logo ImageObject identifies the site. Filling both gives Google the complete picture it expects for article rich results.

Related free tools

• JSON-LD Generator — build other schema types from scratch.
• FAQ Schema Generator — add FAQ rich results to the same page.
• Breadcrumb Schema Generator — mark up your navigation path.
• Organization Schema Generator — define your publisher entity once.

Built by ByteVancer

ByteTools is a free product of ByteVancer, a software and web development studio building web apps, SaaS and custom software. If you need structured data automated across a large CMS or a custom SEO pipeline, explore what ByteVancer can build for you.