Article Schema Markup
The Article type is the most versatile content schema on schema.org. It covers news stories, blog posts, editorials, investigative reports, and general written content. Google says Article markup helps it show better title text, images, and dates for the article in search results.
Google Search Features
- Article Better title text, images and dates for the article in search results.
- Speakable Sections of an article that Google can read aloud on Google Home devices. Beta. Only for English content and Google Home users in the U.S.
- Subscription and paywalled content Tells Google which content is behind a paywall, so it isn't treated as cloaking.
When to Use Article
Properties
| Property | Type | Status | Description |
|---|---|---|---|
| headline | Text | recommended | The headline of the article. Keep it concise: Google says long titles may be truncated on some devices. |
| image | URL or ImageObject | recommended | The main image for the article. Google asks for images of at least 50K pixels (width × height) and recommends 16x9, 4x3, and 1x1 versions. |
| datePublished | Date or DateTime | recommended | The date the article was first published in ISO 8601 format (e.g., 2024-03-15). |
| dateModified | Date or DateTime | recommended | The date the article was last updated. Showing freshness helps with rankings. |
| author | Person or Organization | recommended | The author of the article: a Person or Organization with at least a name. Use an array for several authors. |
| publisher | Organization | recommended | The organization that published the article. Should include name and logo. |
| description | Text | recommended | A short description or summary. Often used as the meta description in search results. |
| articleBody | Text | optional | The full text content of the article. |
| articleSection | Text | optional | The section or category the article belongs to (e.g., Technology, Sports). |
| wordCount | Integer | optional | The approximate number of words in the article. |
| url | URL | recommended | The canonical URL of the article page. |
| mainEntityOfPage | URL or WebPage | optional | Indicates this article is the primary content of the page. |
| keywords | Text | optional | Comma-separated keywords relevant to the article. |
JSON-LD Examples
Basic Blog Post
Minimal Article markup for a blog post with author and publisher.
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "10 Tips for Better SEO in 2024",
"image": "https://example.com/seo-tips-hero.jpg",
"datePublished": "2024-03-15",
"dateModified": "2024-03-20",
"author": {
"@type": "Person",
"name": "Jane Smith",
"url": "https://example.com/authors/jane"
},
"publisher": {
"@type": "Organization",
"name": "Tech Blog",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/logo.png"
}
},
"description": "Discover proven strategies to boost your search engine rankings and increase organic traffic."
}News Article with Multiple Authors
A NewsArticle with co-authors and a full publisher block.
{
"@context": "https://schema.org",
"@type": "NewsArticle",
"headline": "Major Climate Agreement Reached at Summit",
"image": [
"https://example.com/summit-1.jpg",
"https://example.com/summit-2.jpg"
],
"datePublished": "2024-06-01T09:00:00-05:00",
"dateModified": "2024-06-01T14:30:00-05:00",
"author": [
{
"@type": "Person",
"name": "Alice Chen"
},
{
"@type": "Person",
"name": "Bob Martinez"
}
],
"publisher": {
"@type": "Organization",
"name": "Global News Network",
"logo": {
"@type": "ImageObject",
"url": "https://gnn.com/logo.png"
}
},
"description": "World leaders agree to binding emissions targets at the annual climate summit.",
"articleSection": "Environment"
}Common Mistakes
Writing very long headlines — Google says long titles may be truncated on some devices.
Omitting the author property — Google recommends it rather than requiring it (Article markup has no required properties), and it helps Google understand who wrote the article.
Using small images — Google asks for images of at least 50K pixels (width × height).
Putting the publisher logo URL directly in the publisher object instead of wrapping it in an ImageObject.
Using date formats like 'March 15, 2024' instead of ISO 8601 format '2024-03-15'.
Complete Guide to Article Schema Markup
Article schema markup tells search engines that your page contains a written article and describes its headline, images, dates, and author. Google says this helps it show better title text, images, and date information for the article in search results. Google also says there's no markup requirement to appear in Google News features such as Top stories, but Article markup tells it more explicitly what the content is.
Google's Article documentation has no required properties: add the ones that apply to your content, starting with headline, image, datePublished, dateModified, and author. Keep the headline concise, because long titles may be truncated on some devices. Images should be at least 50K pixels when you multiply width by height, and Google recommends providing 16x9, 4x3, and 1x1 versions.
The author property deserves special attention. Google has been increasingly emphasizing author authority as a ranking signal, and proper author markup helps establish E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness). Always use a Person or Organization object with at least a name, and ideally include a URL pointing to the author's profile page.
For news, you can use the more specific NewsArticle subtype, and BlogPosting for blog posts. Both inherit every Article property, and Google's Article documentation supports Article, NewsArticle, and BlogPosting in the same way.
The dateModified property, while technically optional, is strongly recommended. Google uses it to determine content freshness, and pages with recent modification dates often receive a ranking boost for time-sensitive queries. Always update this date when you make substantive changes to the content.
Related Types
Ready to Create Article Markup?
Use our free generator to create valid Article JSON-LD markup with a visual form. No coding required.
Open Generator