SEO & AI search · Guide
How to Add Article Schema in WordPress
Short answer
To add Article schema in WordPress, install Yoast SEO or Rank Math and set Article as the default schema type for posts. Both plugins add the markup for you, including the headline, author, and publish date. You can also add it by hand with a JSON-LD script, then check the page in Google's Rich Results Test.
Key takeaways
- Yoast SEO describes posts with Article schema by default, and pages with WebPage schema.
- Rank Math uses Article as the default schema for posts and pages, with Blog Post and News Article as subtypes.
- Google supports Article, NewsArticle, and BlogPosting, and lists no required properties for Article.
- Include headline, author, datePublished, dateModified, and a representative image in your markup.
- A pass in the Rich Results Test means the page is eligible for a rich result, not that Google will show one.
What is Article schema?
Article schema is structured data that tells search engines a page is an article and gives them its headline, author, and dates.
The Article type covers news articles and other pieces of writing, with properties such as articleBody, articleSection, and wordCount. Google reads this markup to show better title text, images, and date information in search results, according to Google Search Central.
Article schema does not change what visitors see on the page. It lives in the page code as JSON-LD, Microdata, or RDFa, and search engines read it while they crawl the page.
What do you need before you add Article schema?
Before you add Article schema, you need a WordPress site, an SEO plugin, and a post with a real author, a publish date, and a featured image.
- A WordPress post or page that is a genuine article, such as a guide, a news story, or a blog post.
- An SEO plugin that writes schema for you. Yoast SEO and Rank Math both do this in their free versions, and you can compare plugin costs in our guide to free and premium WordPress plugins.
- A named author with a filled-in profile, because a valid Article needs an author.
- A featured image that shows the subject of the article. Yoast's developer docs say the image must be at least 696 pixels wide and in JPG, PNG, GIF, or WebP format, per Yoast's developer docs.
- A short meta description, which Yoast uses as the Article description when no other summary exists.
Set these five items up first. If the author or image is missing, a plugin may skip the Article block or output an incomplete one, because Yoast's developer docs say a node with missing or invalid required fields should not be output.
How do you add Article schema with Yoast SEO?
Yoast SEO adds Article schema to your posts by default, so you only need to check the content type setting and fill in the author and image details.
Yoast describes Pages with WebPage schema and Posts with Article schema by default, according to Yoast's help pages. For most sites, these defaults are enough, and you should not replace them with hand-written markup.
- Install and activate Yoast SEO. If you have not set it up yet, follow our guide to set up Yoast SEO.
- In the WordPress dashboard, go to Yoast SEO, then Settings.
- Under Content types, select Posts.
- Under Schema, confirm Article is selected. This sets the default for all posts.
- Open a post and check the author, the featured image, and the meta description in the Yoast sidebar.
- Publish or update the post.
To change one post only, open the Yoast SEO meta box or sidebar on that post and pick a different page or article type. Yoast's help pages note that some post types do not support authorship, and those cannot output valid Article schema.
The full list of Yoast settings is covered in our guide to Yoast SEO settings.
How do you add Article schema with Rank Math?
Rank Math uses Article as the default schema for posts and pages, so set the default once and check each post in the Schema tab.
Rank Math's knowledge base says Article schema helps search engines understand the headline, publish date, and primary image of an article, per Rank Math. The plugin adds it for you once the Schema module is on.
- Install and activate Rank Math. Our guide to set up Rank Math walks through the first run.
- Go to Rank Math SEO, then Dashboard, then Modules, and turn on the Schema (Structured Data) module.
- Go to Rank Math SEO, then Titles and Meta, then Posts, and set Schema Type to Article. Save your changes.
- Open a post, click the Rank Math SEO icon, and open the Schema tab.
- Click Schema Generator, search for Article, and click Use to open the Schema Builder.
- Check the headline, description, and keywords fields, then pick the Article Type: Article, Blog Post, or News Article.
- Save the schema and update the post.
Rank Math's knowledge base notes that BlogPosting is a more specific type of Article, so a personal blog post can use Blog Post while a general guide stays on Article. For news, Rank Math sets NewsArticle for posts in your News Sitemap by default.
For news articles, the publisher must be an Organization, not a Person, and Rank Math adds it for you. Rank Math's other schema options are covered in our guide to Rank Math schema settings.
How do you add Article schema with code?
You can add Article schema by hand with a JSON-LD script, using the wp_head hook to print it on single posts.
Use this route only when no plugin writes schema for you. If a plugin already outputs Article schema, hand-written code will duplicate it, so pick one route per page.
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "How to Add Article Schema in WordPress",
"image": "https://example.com/images/article-schema.jpg",
"datePublished": "2026-11-19T09:00:00+06:00",
"dateModified": "2026-11-19T09:00:00+06:00",
"author": {
"@type": "Person",
"name": "Jane Doe",
"url": "https://example.com/authors/jane-doe"
}
}
Add the script through a child theme's functions.php file or a code snippets plugin, hooked to wp_head. The wp_head hook reference on WordPress Developer Resources documents where the output goes. Replace every example value with your own post data, and keep the dates in ISO 8601 format with a timezone.
Which properties should your Article schema include?
Include headline, author, datePublished, dateModified, and image at minimum, because Google uses these to show title, date, and image details.
Google lists no required properties for Article, so add the properties that apply to your page, according to Google Search Central. The table below lists the ones that matter most.
| Property | What to put in it | Why it matters |
|---|---|---|
| headline | The post title | Shows as the title in search results |
| author | Author name and author page URL | Names who wrote the article |
| datePublished | First publish date and time, ISO 8601 | Shows the publish date |
| dateModified | Last edit date and time, ISO 8601 | Shows how fresh the article is |
| image | Representative image URL | Can appear with the result |
| publisher | Your site as an Organization | Needed for news articles |
Google asks for images that show the article subject, not logos or captions. Google also suggests images of at least 50,000 pixels in size, in 16x9, 4x3, and 1x1 ratios, for the best display.
Article, BlogPosting, or NewsArticle: which type should you pick?
Use Article for a general article, BlogPosting for a personal blog post, and NewsArticle only for timely news.
Google supports three types for article pages: Article, NewsArticle, and BlogPosting, according to Google Search Central. Pick the one that matches the page, not the one you think ranks best.
| Type | Use it for | Example |
|---|---|---|
| Article | A general article or guide | A how-to guide |
| BlogPosting | A personal blog post | A diary-style post |
| NewsArticle | A timely news story | A breaking news report |
Rank Math offers the same three choices as Article Type, and sets NewsArticle by default for posts in your News Sitemap, per Rank Math. A guide or tutorial should stay on Article even if it reads like a blog post.
How do you check that Article schema works?
Paste the live post URL into Google's Rich Results Test and the Schema Markup Validator, then fix every error they report.
- Open the Rich Results Test, paste the post URL, and run the test.
- Look for Article under the detected items and check that it shows no errors.
- Open the Schema Markup Validator, paste the same URL or the JSON-LD code, and check for unknown properties or wrong types.
- In Search Console, use the URL Inspection tool to see how Google reads the page, and ask Google to recrawl it if the page looks right.
A pass means the page is eligible for a rich result, not that Google will show one. Google states that it does not guarantee structured data will show up in search results, even when the markup passes the test.
How long does it take to add Article schema?
Adding Article schema takes about 10 minutes for one post with a plugin, and under an hour to set the defaults for a whole site.
The plugin route is quick because the markup is automatic. The code route takes longer, since you must write the JSON-LD, add it to the theme, and test it.
Google still needs time to find and crawl the changed page. Google notes that it may take several days after publishing for Google to find and crawl a page, so do not expect the result to change the same day.
What mistakes should you avoid?
Do not mark a page as an article when it is not one, do not add the same Article block twice, and do not leave the author or dates blank.
- Using Article schema on a page that is not an article, such as a contact page or a product page. Use WebPage or the type that fits the page instead.
- Running a plugin and hand-written code at the same time, which puts two Article blocks on one page.
- Leaving the author blank. Yoast notes that a valid Article needs an author, so post types without authorship cannot output one.
- Putting a logo in the image field. Google asks for an image that shows the article subject.
- Setting dateModified earlier than datePublished, or leaving dates out after an update.
- Expecting a rich result the day you publish. A clean test means the page is eligible, and Google decides what to show.
Frequently asked questions
Does WordPress add Article schema on its own?
No. WordPress core does not add Article schema to posts. You need an SEO plugin such as Yoast SEO or Rank Math, or hand-written JSON-LD code, to add it. Both plugins cover posts by default once they are installed and set up.
Do I need Article schema on every post?
Add it to pages that are genuine articles, such as guides, news stories, and blog posts. Pages that are not articles, such as a contact page or an about page, should use WebPage or another type that matches what the page actually is.
Will Article schema improve my rankings?
Google says structured data helps it understand the page and show better title, image, and date information in search results. Google does not promise a ranking boost or a rich result, even when the markup passes the Rich Results Test.
Can I use Article schema and FAQ schema on the same page?
Yes. Different schema types can sit on the same page, so an article can carry Article schema plus a separate FAQ block when the page has a real question and answer section. Do not add two Article blocks to one page, and only mark up content that visitors can actually see.
Why does the Rich Results Test show no Article item for my post?
The usual causes are a disabled Schema Framework or Schema module, a post type without an author, a page blocked by robots rules, a noindex tag, or a login wall. Check the plugin setting is on, view the page source for the JSON-LD block, then re-run the test on the live URL.
Sources
- Article Structured Data Google Search Central
- Article - Schema.org Type Schema.org
- The Page or Article type in your Schema settings Yoast
- Schema piece - Article Yoast Developer Portal
- Article Schema Type Rank Math
- Schema Markup Validator Schema.org
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
