How to use the Article Schema Generator
The article schema generator builds Article JSON-LD from a short form. It runs in your browser, so nothing you type is uploaded.
- Choose the article type. Pick
BlogPostingfor blog posts,NewsArticlefor news reporting, orArticlefor everything else, such as guides and long-form features. - Enter the headline exactly as it appears on the page. Keep it concise. Google’s guidance is that long headlines may be truncated.
- Enter the page’s canonical URL. This is the address you want treated as the primary version of the article.
- Add one or more image URLs. Use full, public URLs to images that appear in the article, ideally in several aspect ratios.
- Enter the author’s name and, if you have one, the URL of an author page. Add the publisher name and logo URL if you want the publisher to be described as well.
- Set the published date and, if the article has been meaningfully updated, the modified date. Use the date and time pickers so the output is in ISO 8601 format with a time zone.
- Add an optional short description, section and keywords. Copy the generated JSON-LD, paste it inside a
<script type="application/ld+json">tag on the article page, and test it with a validator before you publish.
Tip: Use the same author name, headline and dates that readers see on the page. The markup should describe the article, not decorate it.
What Article schema is
Article schema is structured data that describes a piece of written content: who wrote it, what it is called, when it was published and updated, which images belong to it and who published it. It uses the Article type from schema.org and two of its more specific subtypes, NewsArticle and BlogPosting.
A page already contains most of this information, but it is scattered across the layout. The byline sits in one element, the date in another, the image in a third. A machine has to figure out which date is the publication date and which person is the author. Article markup states these facts directly in one place, in a format designed for the purpose.
The three Article types
Articleis the general type. Use it for guides, features, essays, research write-ups and other long-form content.BlogPostingis a subtype for blog posts. It carries the same properties asArticle.NewsArticleis a subtype for news reporting. Use it for stories from a news publisher, not for marketing posts that borrow a news tone.
The practical difference between them is small. Pick the most accurate one. If you are unsure, Article is always valid.
The core properties
headline: the title of the article.author: aPersonorOrganizationwith anameand, ideally, aurl.datePublishedanddateModified: ISO 8601 dates.image: one or more image URLs.publisher: theOrganizationthat publishes the content.mainEntityOfPage: the canonical page URL, tying the article to the page it lives on.description: a short summary.articleSection,keywords,wordCount,inLanguage: optional descriptive properties.
Google’s Article structured data guidance lists no strictly required properties, but it recommends author, datePublished, dateModified, headline and image. The more of these you fill in accurately, the more complete the picture.
Why Article schema matters for AI search and answer engines
Answer engines care about two questions when they choose a source: is this content relevant to the prompt, and can it be trusted and verified? Article markup does not answer the first, but it can help with the second.
It identifies who is behind the content
A clear author with a name and a link to a profile page lets a system connect the article to a real person or organization. Systems that weigh the credibility of a source can use that connection. An article with no visible author and no markup gives them nothing to weigh. Google’s own guidance on helpful content encourages making authorship clear to readers, and structured author data supports that.
It states freshness explicitly
Many questions are time-sensitive: prices, laws, software features, rankings, statistics. Engines prefer sources that are current. datePublished and dateModified let you state when the content was first written and when it was last meaningfully updated, in a standard format that no layout can obscure. That gives a retrieval system a reliable freshness signal, which is particularly relevant for the kind of content AI assistants like to cite.
It clarifies what the page is
Marking a page as an Article, rather than leaving it as a generic web page, tells a machine that it is dealing with an editorial piece with a headline and a byline, not a product listing or a landing page. That helps with classification.
It supplies images and titles reliably
For search features that show a title and a thumbnail, the headline and image properties give Google clean values to use. Google may still choose a different title or image, but your markup is one of the inputs.
What it does not do
Article schema does not make a weak article rank, and it does not guarantee that any AI engine will cite you. It also cannot rescue content with no author, no date and no substance. Engines evaluate the text itself. Markup is supporting context. It does not replace quality.
How Google and other systems use Article markup
Google reads Article structured data to understand the page and may use it in features such as Top stories and in the display of titles, images and dates in results. It does not require the markup to index the page, and there is no special badge for having it. Other search engines and content pipelines read schema.org Article data in similar ways, and Bing indexes the same markup.
For AI assistants, the picture is less documented. Some retrieve live pages and read the full HTML, which includes your JSON-LD. Some work from a search index. Some draw on earlier training data. The visible text and the page’s overall clarity matter most in each of these cases, and the markup is a helpful supplement, not a lever.
Why dates deserve special care
Because freshness is useful, there is a temptation to change dateModified without changing the content. Do not. Update the modified date only when the article has been meaningfully revised, such as new facts, corrected claims or additional sections. Search systems compare dates with the actual content and with other signals, and artificially refreshed dates can erode trust.
Article schema rules to follow
- Markup must match the visible page. The headline, author and dates in the JSON-LD should be the same as those that readers see.
- Use real dates in ISO 8601. Include a time zone, for example
2026-03-04T09:30:00-05:00. A date without a time, such as2026-03-04, is also valid. - Use real names for authors. Give the author’s actual name, not a job title, a company slogan or a list of several names in one string. Use separate
Personentries for multiple authors. - Do not put a company name in the author name field when a person wrote the piece. If the article is genuinely published by the organization with no named author, use an
Organizationas the author. - Images must be crawlable. Image URLs must be reachable and indexable, and the image should be relevant to the article, not a generic logo.
- Keep the headline concise. Very long headlines can be truncated in search features.
- One article, one markup block. Do not output two Article entities for the same page.
Best practices
Pick the right type
Use BlogPosting for blog posts, NewsArticle for journalistic news content and Article for the rest. Do not label opinion or marketing content as NewsArticle.
Make authors real and findable
Show the author’s name on the page and link it to an author page that has a short bio, credentials relevant to the topic and links to their other work. Then use that author page URL in the markup. A Person author with a url and a few sameAs profiles is a much stronger signal than a bare name. If you use a pen name or a team byline, be honest about it.
Provide several image sizes
Google recommends supplying multiple high-resolution images, ideally at least 50,000 pixels when width and height are multiplied, in 16:9, 4:3 and 1:1 aspect ratios. This lets different surfaces choose the best crop. You do not need three different images; three crops of the same one are fine. Use formats Google Images supports, such as JPG, PNG or WebP.
Be honest and consistent with dates
Set datePublished once and leave it alone. Update dateModified whenever you meaningfully revise the article, and show a matching “Last updated” line on the page. Time zones matter: an article published at 9 p.m. in New York is on a different calendar day in London, so include the offset.
Connect the publisher
Reference your Organization by @id so the Article is tied to the same entity as your home page markup. Our Organization Schema Generator builds that block. If you do not have an Organization entity yet, a simple inline publisher with a name and logo URL is fine.
Add mainEntityOfPage
Set mainEntityOfPage to the canonical URL of the article. It states which page this Article describes, which is particularly helpful when the same piece is reachable at several URLs.
Write a good description
The description property can hold a one or two sentence summary. Make it a real summary of the article, not a keyword list. It can also be the same text as your meta description.
Use one entity per page and avoid conflicts with plugins
Most SEO plugins already output Article or WebPage graphs for posts. Check what your page outputs before adding a hand-built block, and use the plugin’s own settings where possible. If you must override it, disable the plugin’s output for that page rather than outputting two competing blocks.
Validate and keep an eye on it
Run the code through the Schema Markup Validator and Google’s Rich Results Test. After publishing, watch Search Console for structured-data issues, and recheck after theme or plugin updates.
Examples
A minimal BlogPosting
This is a compact, valid example with the recommended fields.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "How to plan a small construction project",
"description": "A step-by-step guide to scoping, scheduling and budgeting a small build.",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://www.example.com/blog/plan-a-small-build/"
},
"image": [
"https://www.example.com/images/plan-16x9.jpg",
"https://www.example.com/images/plan-4x3.jpg",
"https://www.example.com/images/plan-1x1.jpg"
],
"author": {
"@type": "Person",
"name": "Jane Doe",
"url": "https://www.example.com/authors/jane-doe/"
},
"datePublished": "2026-03-04T09:30:00-05:00",
"dateModified": "2026-05-12T14:00:00-04:00"
}
</script>
Article with a connected publisher
Here the publisher is defined once as an Organization and referenced from the Article by @id.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://www.example.com/#organization",
"name": "Example Co",
"url": "https://www.example.com/",
"logo": "https://www.example.com/images/logo-512.png"
},
{
"@type": "Article",
"@id": "https://www.example.com/guides/site-planning/#article",
"headline": "A practical guide to site planning",
"mainEntityOfPage": "https://www.example.com/guides/site-planning/",
"image": ["https://www.example.com/images/site-planning.jpg"],
"author": {
"@type": "Person",
"name": "Jane Doe",
"url": "https://www.example.com/authors/jane-doe/",
"sameAs": ["https://www.linkedin.com/in/jane-doe-example"]
},
"publisher": { "@id": "https://www.example.com/#organization" },
"datePublished": "2026-01-15",
"dateModified": "2026-06-02",
"articleSection": "Guides",
"inLanguage": "en-US"
}
]
}
</script>
Article with two authors
Use an array of Person entries when more than one person wrote the article. Do not combine names into one string.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "What we learned from 12 renovations",
"author": [
{
"@type": "Person",
"name": "Jane Doe",
"url": "https://www.example.com/authors/jane-doe/"
},
{
"@type": "Person",
"name": "Sam Rivera",
"url": "https://www.example.com/authors/sam-rivera/"
}
],
"datePublished": "2026-02-20T08:00:00Z",
"image": "https://www.example.com/images/renovations.jpg"
}
</script>
Escaping special characters
JSON strings need double quotes escaped, and line breaks written as \n or avoided altogether. A headline that contains a quotation mark looks like this. The generator escapes it for you.
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "Why \"good enough\" estimates cost you money",
"datePublished": "2026-04-01"
}
Where the pieces must appear on the page
Because markup should match visible content, check that each piece of data has a counterpart a reader can see.
- The headline is the page’s main heading or the title above the content.
- The author appears in a byline near the top or bottom, preferably linked to an author page.
- The published and modified dates are shown as readable text. A “Last updated” label is helpful when you revise content.
- The image appears in the article body or as its featured image.
- The publisher is visible through your site name, logo or footer.
If one of these is not on the page, either add it for the reader or leave the property out of the markup.
Building author pages that back up the markup
The author property is only as strong as the page it points to. If the url leads to a thin or empty page, the link adds little. A good author page does a few simple things.
- It names the person and shows a photo, so readers know a real human wrote the article.
- It includes a short bio that explains the person’s experience with the topics they write about, in plain factual terms.
- It lists the articles the person has written, which lets readers and machines see their body of work.
- It links to the person’s official profiles, such as LinkedIn, a personal site or a professional directory. Those same URLs can go in the
sameAsproperty of the author’sPersonentry.
Do not exaggerate credentials. Claim only what you can support, because the claim may be checked against other sources. If your articles are written by a team, a clear editorial policy page that explains who writes and who reviews can serve the same purpose.
A pre-publish checklist
Run through this list before you publish or update an article with new markup.
- The headline in the JSON-LD matches the visible page title.
- The author name matches the byline, and the author URL opens a real page.
datePublishedis correct anddateModifiedreflects a genuine revision.- Every image URL loads in a browser without logging in, and each image is relevant to the article.
- The publisher is an Organization that matches your home page markup, referenced by
@idwhere possible. - There is only one Article entity in the page source. Search the source for
"@type":"Article",BlogPostingandNewsArticleto check. - The JSON passes the Schema Markup Validator with no errors.
- The canonical URL in
mainEntityOfPageis the same one in the page’s canonical link tag.
Article markup for updated and evergreen content
Evergreen guides get edited many times over the years. The cleanest practice is to keep datePublished as the original publication date and move dateModified forward each time you make a real improvement. Pair that with a visible note, for example “Updated June 2, 2026: added new pricing details.” The note helps readers, and it lets a machine see that the change was substantive.
If an article is rewritten so thoroughly that it is effectively a new piece, consider whether it should be a new URL with a fresh publication date and a redirect or a link to the earlier version. Judge by what is honest for the reader: an article that now says the opposite of what it said before is not the same article.
Adding the markup to your site
WordPress
WordPress SEO plugins typically add Article schema to posts automatically, using the post’s title, author, dates and featured image. In most cases the best move is to make sure the author profile, featured image and publisher details are complete, and let the plugin do the work. The free aeoora WordPress plugin outputs schema without creating duplicates and respects markup from your SEO plugin. See the WordPress integration page.
Static sites and custom builds
Generate the JSON-LD from the same front matter that renders the page: title, author, dates and image. That keeps markup and content in sync with no extra effort. In a template language, escape the values so that quotes in titles cannot break the JSON.
Hand-pasted markup
For a one-off page, paste the generator’s output in the head or at the end of the body. Remember to update the modified date and the code whenever you revise the article.
Common mistakes
- Faking the modified date. Changing
dateModifiedwithout changing the content is a trust problem. Update it for real revisions only. - Missing or fake authors. A generic “Admin” or “Editorial Team” byline with no page behind it adds nothing. Name a real person, or be clear that it is the organization.
- Putting several names in one author string. “Jane Doe and Sam Rivera” should be two
Personentries. - Using NewsArticle for marketing posts. Reserve it for real news reporting.
- Mismatched headline. A headline in markup that differs from the visible title creates confusion about what the page is.
- Invalid dates. Formats like “March 4, 2026” are not ISO 8601. Use
2026-03-04or a full timestamp. - Tiny or irrelevant images. A 100-pixel logo is not a good article image. Use a relevant, high-resolution picture.
- Duplicate Article blocks. A plugin and a hand-pasted block may both output Article data. Output it once.
- Broken JSON. Unescaped quotes and trailing commas are the most common causes. Use the generator and a validator.
- Treating markup as a ranking trick. The goal is to describe the page accurately. It does not replace the quality of the article.
Frequently asked questions
Is Article schema required for my blog posts to rank?
No. Pages are indexed and ranked without it. Article markup is a way to make authorship, dates and images explicit, and to give search systems clean data to work with. It supports understanding, but it does not replace good content.
Should I use Article, BlogPosting or NewsArticle?
Use BlogPosting for blog posts, NewsArticle for news reporting from a news publisher and Article for other editorial content. The properties are the same, and the differences are small. Choose the most accurate type. If in doubt, Article is valid.
Does Article schema help my content get cited by AI assistants?
It can help make your content easier to classify and verify, with a clear author, date and publisher. No provider guarantees that structured data affects citations, though. Relevance, authority, freshness and how directly the page answers the prompt matter most. Think of the markup as supporting context.
What date format should I use?
Use ISO 8601. A date alone, such as 2026-03-04, is valid. A full timestamp with an offset, such as 2026-03-04T09:30:00-05:00, is better because it removes ambiguity about the time zone.
How many images should I include?
At least one. Google recommends offering several high-resolution images in different aspect ratios, such as 16:9, 4:3 and 1:1, so each surface can pick the best crop. The images should be relevant to the article and publicly crawlable.
Can the author be a company instead of a person?
Yes. If the article is published by the organization with no individual byline, use an Organization as the author. If a person wrote it, name them. Readers and search systems both give more weight to a real person with a visible profile.
How often should I update dateModified?
Whenever you make a meaningful revision: new information, corrected facts or added sections. Do not change it for typo fixes or layout changes, and never to appear fresh. Show a matching “Last updated” date on the page.
My SEO plugin already adds Article schema. Do I need this?
Probably not. Check your page source first. If your plugin outputs complete, correct markup, there is no need to add another block, and a second block can cause conflicts. Use the generator to compare, to build markup for custom pages or to fix gaps the plugin leaves.
Go further with aeoora
Article markup is one piece of making a page easy for AI engines to understand and trust. aeoora Cloud helps with the rest: it tracks where your brand and your pages appear in answers from ChatGPT, Gemini, Perplexity, Claude and Google’s AI features, shows which of your pages get cited, and points to the content gaps worth fixing. The Content Editor helps you write answer-ready articles, and the Site Audit flags structured-data and content problems across your site. View pricing or start a 2-day free trial.
If your site runs on WordPress, the free aeoora plugin gives you schema without duplicates, Markdown versions of your posts, llms.txt and AI crawler controls. See the WordPress integration. For the full set of generators and checkers, including the FAQ and Organization schema tools, visit the free tools page.