← Back to Blog
Schema Markup

How to Add Article Schema to WordPress

Article schema tells Google who wrote a page, when, and what it covers. This step-by-step guide shows UK site owners how to add and test it in WordPress.

By Paal Soberg
How to Add Article Schema to WordPress

What you'll achieve

By the end of this guide, every blog post on your WordPress site will carry correct article schema. You will know what the markup says, who it is for, and how to test it. It suits owners and solo marketers with no developer on hand. Allow about 30 minutes for a plugin set-up, or an hour if you write the code yourself. No coding experience is needed for the plugin route.

What is article schema?

Article schema is a block of structured data that describes a blog post or news story in a format search engines read easily. It states the headline, author, publication date, last-updated date and main image. Visitors never see it. Google and other crawlers do.

Google's own documentation says Article structured data can help Google understand more about the web page and show better title text, images and date information in search results. Google does not promise any particular display, and it does not promise a ranking boost. Think of it as labelling. You are removing guesswork about what the page is.

The usual format is JSON-LD, a small script in the page's code. Google supports other formats too, but JSON-LD is the easiest to add and maintain.

If you are new to the wider topic, our schema markup for beginners guide covers the basics. For a property-by-property reference, see the article schema markup page.

Which type should you use: Article, BlogPosting or NewsArticle?

Google's documentation groups three types together: Article, NewsArticle and BlogPosting. They are close relatives.

  • BlogPosting suits most business blogs: advice, guides, opinion and updates.
  • NewsArticle suits timely reporting from a publisher with a news-style site.
  • Article is the general parent type. Use it if neither of the others fits.

For a typical UK service business or online shop, BlogPosting is the sensible default. Picking the wrong sibling is rarely a disaster, but the most specific accurate type is the tidiest choice.

What you need

  • Admin access to your WordPress site
  • A list of your published posts, or at least one live post URL to test
  • A real author name for each post, ideally with an author page
  • Your business name and logo file
  • A featured image on each post
  • Either a schema-capable SEO plugin (Yoast SEO, Rank Math or Schema Pro, for example) or a way to add code to your theme
  • A recent backup of your site

Step 1: Check what schema your site already outputs

Many WordPress themes and SEO plugins already add some article schema. Adding a second copy creates duplicates and conflicting data, which is the most common mistake here.

Pick one recent blog post. Paste its URL into Google's Rich Results Test or the Schema Markup Validator at validator.schema.org. Note whether an Article or BlogPosting item appears, and which fields are filled in. You can also run the page through our schema markup validator to see what is missing.

Step 2: Choose your method

You have two realistic routes in WordPress.

A plugin is the better choice for most businesses. It writes the markup for every post automatically and pulls the details from the post itself. Hand-coded JSON-LD gives full control but must be updated per post or via a template, and it is easy to let drift out of date.

Choose a plugin unless you have a developer and a reason not to. If your theme or SEO plugin already outputs article schema, you may only need to adjust its settings rather than install anything new.

Step 3: Set up your site-wide details in a plugin

Open your SEO plugin's settings and find the section for site or organisation details. In Yoast SEO, this sits under the general settings for site representation. Rank Math has a similar setup in its titles and meta area.

Enter your business name, upload your logo, and say whether the site represents an organisation or a person. These details become the publisher information in every article's markup. Use exactly the same business name you use on your site and Google Business Profile. Inconsistent naming makes it harder for search engines to link your content to one business.

Step 4: Set the default schema type for posts

Still in the plugin settings, find the default schema or content type for posts. Set the page type to a standard web page and the article type to BlogPosting (or Article, if you prefer).

In Yoast, this is under the content types settings. In Rank Math, look in the titles and meta settings for posts. In Schema Pro, create a new schema, choose Article as the type, and select the posts it applies to using display rules.

Apply the default to posts only. Do not apply it to service pages, contact pages or product pages, which are not articles.

Step 5: Check the author on each post

Every article should name a real person or organisation as author. Go to Users in WordPress and check that each author has a proper display name, not a username such as "admin". Add a short bio and, if you can, a link to a profile page.

Google's documentation notes that an author URL helps Google disambiguate the correct author of the article. A page on your own site with the author's name and background does that job well. Common mistake: leaving the author as the site admin on every post.

Step 6: Add a featured image to each post

Google recommends giving the article an image it can crawl and index. In WordPress, set a featured image in the post editor's sidebar, and most plugins pass it into the markup automatically.

Use a decent-sized image that relates to the article, not a tiny icon or a logo. If you have older posts without featured images, add them now. This is the field most often missing when you test older content.

Step 7: Keep the dates accurate

Article schema carries two dates: when the post was first published (datePublished) and when it was last meaningfully changed (dateModified). Plugins take these from WordPress automatically.

Update the modified date only when you genuinely change the content. Nudging it forward on untouched posts to look fresh is misleading, and it works against the whole point of marking up dates honestly. Real refreshes, with new facts or corrected advice, are what the modified date is for.

Step 8: Write a clear headline

The headline property should match the visible title of the post. Google removed its old 110-character limit in January 2023 and now advises concise titles, because long titles may be truncated on some devices. Most plugins use your post title by default.

Check that the title in the markup matches the H1 on the page. If your SEO title differs from your on-page heading, make sure the schema headline follows the on-page heading.

Step 9: Test a live post

Save your settings and clear any caching plugin. Then test a published post URL in the Rich Results Test and the Schema Markup Validator. Look for one Article or BlogPosting item with your headline, author, image, dates and publisher filled in.

Test at least one older post and one new post, because older content is where gaps usually show up. A warning about a missing optional field is not a failure. An error, or a duplicate item, needs fixing.

Step 10: Fix duplicates and errors

If you see two Article items, one will usually come from the theme and one from the plugin. Switch off one source. Most plugins have a setting to turn off their schema output, and many themes have a similar option in their settings.

If a field is empty, trace it back to where WordPress stores it: the author profile, the featured image or the site settings from Step 3. Fix it at the source, then retest. Avoid pasting a manual script on top of a plugin that already outputs markup.

What hand-coded article schema looks like

If you take the manual route, a BlogPosting block looks like this. Replace every value with your own, and paste it into the post using a custom HTML block or through your theme's header template.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Your post title",
  "image": ["https://example.co.uk/images/featured.jpg"],
  "datePublished": "2026-11-21T09:00:00+00:00",
  "dateModified": "2026-11-21T09:00:00+00:00",
  "author": {
    "@type": "Person",
    "name": "Jane Smith",
    "url": "https://example.co.uk/about/jane-smith"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Your Business Ltd",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.co.uk/images/logo.png"
    }
  }
}
</script>

Every value must match what is visible on the page. Markup that describes something readers cannot see breaks Google's guidelines.

Common questions about article schema

Is article schema required?

No. Google's article documentation treats the properties as recommendations rather than strict requirements. Your pages can be indexed without it. It is still worth adding, because it removes ambiguity about authorship and dates.

Will article schema improve my rankings?

Nobody can honestly promise that. Google presents structured data as help in understanding a page and presenting it in results. Content that answers the searcher's question better than what already ranks is what moves rankings.

Does article schema help with ChatGPT and AI answers?

There is no published guarantee that it does. What helps in AI answers is the same as in classic search: clear, specific pages that answer real questions, with a named author and honest dates. Article schema supports that clarity, but it is not a shortcut.

Do I need to add it to every page?

No. Add it to blog posts and article-style pages only. Use other types for products, local business details or FAQs, and see the schema markup reference for what each one is for.

What to do next

You now have article schema running on your WordPress posts, with the right type, a named author, a real image, honest dates and a clean test result. Next, set a reminder to retest one post after any theme or plugin update, since updates are the usual reason markup quietly breaks.

Schema only labels a post. You still need posts worth labelling, on a steady schedule. ClimbrIQ writes and publishes to WordPress automatically, with a 24-hour window on every article for you to edit, hold or veto it.

Want articles like this written for your site?

Connect your site. ClimbrIQ crawls it, works out what you should be ranking for, then writes and publishes 16 articles a month to your CMS. Nothing goes live until you have had 24 hours to stop it.

Curious how AI describes your business? Try the free AI visibility check