Article JSON-LD Schema Template
Article structured data enables Google to understand and display blog posts and news articles as rich results in Google News, Discover, and mobile search. An Article schema with a high-quality image attached can also trigger the Top Stories carousel for news content, which appears at the very top of search results pages and captures a disproportionate share of clicks.
The Schema.org type hierarchy for articles is important to get right. Use Article for generic editorial content, BlogPosting for content published on a personal or company blog, NewsArticle for journalistic news reporting, and TechArticle for technical documentation and tutorials. Choosing the correct type helps Google correctly classify and surface your content in the right contexts. BlogPosting and NewsArticle both extend Article, so all Article properties apply.
Author markup has become increasingly important for Google's E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) signals. Use a Person object with name, url (linking to an author bio page), and sameAs properties pointing to verified social profiles (LinkedIn, Twitter/X verified accounts, Wikipedia if applicable). For organizations publishing content under a brand rather than an individual author, use an Organization object instead.
The headline field must match the actual H1 of the article and be under 110 characters. The image field is mandatory for eligibility for rich results — provide a high-resolution image (at least 1200px wide) in 16:9 aspect ratio for best results in Google Discover and AMP stories. Both image URL and full ImageObject with width, height, and caption are accepted.
datePublished and dateModified must be in ISO 8601 format (2024-03-15T09:00:00Z) and must accurately reflect when the content was published and last updated. Google uses dateModified to assess content freshness. Artificially setting dateModified to today's date for old articles that have not been updated is a violation of Google's policies and can result in demotion.
The publisher field (Organization with logo) is required for Google News eligibility. The logo must be a Google-approved aspect ratio (between 60:600px and 1:1), and the organization's name must match the site's name in Google Search Console.
Template Preview
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Article Title Here",
"description": "Brief article description for search snippets.",
"image": {
"@type": "ImageObject",
"url": "https://example.com/article-image.jpg",
"width": 1200,
"height": 675
},
"datePublished": "2024-01-15T09:00:00Z",
"dateModified": "2024-01-20T09:00:00Z",
"author": {
"@type": "Person",
"name": "Author Name",
"url": "https://example.com/author/author-name"
},
"publisher": {
"@type": "Organization",
"name": "Site Name",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/logo.png"
}
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/article-url"
}
}Customize this template with your own details using the free generator:
▸Open in GeneratorFAQ
- Should I use Article, BlogPosting, or NewsArticle for my content?
- Use NewsArticle for timely news reporting with a publication date that is meaningful to the reader. Use BlogPosting for opinion pieces, personal stories, and evergreen educational content on a blog. Use TechArticle for programming tutorials, API documentation, and technical how-to guides. Use the base Article type when none of the above subclasses fit. The distinction matters because Google News and Discover have different eligibility requirements for different content types.
- Is Article schema required to rank in Google Search?
- No, structured data is not a ranking factor in the traditional sense — it does not boost your position in the standard blue-link results. Its value is enabling rich result eligibility: the Top Stories carousel, Google Discover cards with expanded images, and byline information in search snippets. If you are not targeting news traffic or do not have author authority, the SEO benefit of Article schema alone is modest.
- How many images should I specify in the Article schema image field?
- Provide multiple image sizes to give Google options for different display contexts. The image field accepts an array: include a 16:9 version (1200×675), a 4:3 version (1200×900), and a 1:1 version (1200×1200). Google selects the most appropriate ratio for the display surface — Discover cards use 16:9, AMP articles may use 1:1. Providing all three ensures optimal presentation across all Google surfaces.