How to Fix: JSON-LD format

JSON-LD format is an important SEO check in the Structured Data & Schema category. This is a medium-priority issue. While not urgent, fixing it will improve your overall SEO health.

What is This Check About?

This check verifies that your structured data is delivered as JSON-LD — the format Google explicitly recommends — and that it is valid. Structured data is the machine-readable summary you attach to a page so search engines understand what it is: an article, a product, a recipe, a local business, an FAQ. There are three ways to mark it up (JSON-LD, Microdata, and RDFa), but Google has been clear for years that JSON-LD is its preferred format. When this check fails, it usually means either you have no structured data at all, or you have it in an older inline format, or the JSON-LD you have is malformed and search engines are silently discarding it.

The reason JSON-LD won is worth understanding, because it explains why this is the low-effort, high-clarity choice. Microdata and RDFa tangle the machine-readable data into your visible HTML, attribute by attribute, so a template change can quietly break your schema. JSON-LD sits in a single <script> block, cleanly separated from the markup a human sees. It is easier to generate, easier to validate, and far harder to break by accident. Choosing it is choosing the format that stays correct while your theme evolves.

Why Does This Matter for SEO?

Search engines like Google evaluate hundreds of factors when ranking websites. JSON-LD format is one of these important factors because:

• It affects how search engines crawl and understand your content
• It impacts user experience, which is a key ranking factor
• It can influence your site’s visibility in search results
• Ignoring it may cause your competitors to outrank you

Structured data does not directly move you up the rankings, and I would be lying to you if I said it did — Google has been consistent that it is not a ranking factor in that sense. What it buys you is eligibility for rich results: the star ratings, prices, FAQ dropdowns, recipe cards, and breadcrumb trails that make your listing physically larger and more clickable than the plain blue links around it. That click-through advantage is real and measurable, and it compounds. Two sites can rank in the same position and the one with a rich result quietly wins the traffic. Valid JSON-LD is the price of admission to that competition; malformed JSON-LD is a ticket Google throws away at the door.

How to Check This Issue

You can identify this issue by:

1. Running an SEO audit using the SEO Roadmap tool
2. Manually inspecting your website’s source code and settings
3. Using browser developer tools (F12) to analyze page elements
4. Checking Google Search Console for related warnings or errors

The definitive tools here are Google’s own. Paste a URL into the Rich Results Test and it tells you exactly which schema types Google detected, whether they are valid, and which rich result they qualify for. The Schema Markup Validator (from Schema.org) is the stricter, format-level check for the JSON-LD syntax itself. Between them you get both answers: is my JSON well-formed, and does Google accept the types I declared. In Search Console, the Enhancements reports flag structured-data errors across the whole site once Google has recrawled, which is how you catch a template-wide problem rather than one bad page.

How to Fix This in WordPress

Difficulty Level: EASY – This fix is straightforward and can typically be completed by anyone with basic WordPress knowledge.

Estimated Time: 15 min

Follow these steps to fix this issue:

Step 1: Identify Affected Pages

First, run a complete SEO audit to identify all pages affected by this issue. The SEO Roadmap tool will show you exactly which URLs need attention. Note the page types as you go — a blog post wants Article schema, a product wants Product, a category-plus-service page might want LocalBusiness. The fix differs by type, so grouping them saves time.

Step 2: Access WordPress Settings

Log into your WordPress admin dashboard. Depending on the specific issue, you may need to navigate to:

• Settings → General for site-wide configurations
• Settings → Reading for indexing and visibility settings
• Settings → Permalinks for URL structure issues
• Appearance → Theme Editor for template-level fixes
• Plugins → Installed Plugins to configure SEO plugins

The good news for WordPress is that you almost never hand-code this. Yoast SEO and Rank Math both build a complete, valid JSON-LD graph for you automatically, and it is already in the recommended format. Most of the time this fix is simply confirming your SEO plugin’s schema output is switched on and correctly configured for each content type — not writing anything.

Step 3: Apply the Fix

Make the necessary changes based on the specific issue. If you’re using an SEO plugin like Yoast SEO or Rank Math, many of these settings can be configured through the plugin’s interface. If you do need to add schema by hand — a custom type your plugin does not cover — the shape is a single script block in the page head, like this:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Your Post Title",
  "datePublished": "2026-01-15",
  "author": {
    "@type": "Person",
    "name": "Author Name"
  }
}
</script>

The one rule that matters most: the values in your JSON-LD must match what a human actually sees on the page. Do not mark up a review rating that is not displayed, or an author who is not credited. Google calls that out specifically as a policy violation, and it will pull your rich results — or worse — if it catches the schema describing something the page does not show. Keep the two honest and identical.

Step 4: Verify the Fix

After making changes:

1. Clear your WordPress cache if you’re using a caching plugin
2. Re-run the SEO Roadmap audit to confirm the issue is resolved
3. Check Google Search Console after a few days to ensure Google has recognized the fix

Always re-run the Rich Results Test on the live URL after any change, not just the audit tool. It is the closest thing you have to seeing the page through Google’s eyes, and it will catch a broken value your cache or a second plugin quietly introduced.

The duplicate-schema trap that two plugins create

Here is the failure I see far more often than genuinely absent schema, and it is almost always self-inflicted. A site runs an SEO plugin that outputs JSON-LD, and also a theme that outputs its own schema, and also a dedicated schema plugin someone installed a year ago and forgot. Now the page ships two or three competing Article blocks, or two Organization definitions with different logos, and Google has to guess which one is authoritative. Sometimes it picks the wrong one; sometimes it flags a conflict and ignores all of them. You went to the trouble of adding structured data and ended up worse off than a page with none.

So before you add anything, do the subtraction first. View the page source, search for application/ld+json, and count the blocks. If there is more than one source generating schema, pick a single owner — on WordPress that should almost always be your one SEO plugin — and turn the others off. One clean, consolidated JSON-LD graph beats three partial ones every time. This ten-minute audit prevents the most common structured-data headache there is, and it is the first thing I check on any site where the rich results “should be working” but are not.

Recommended Tools & Plugins

These tools can help you fix and prevent this issue:

• Yoast SEO – Comprehensive SEO plugin with built-in checks
• Rank Math – Feature-rich SEO plugin with detailed analysis
• Google Search Console – Free tool to monitor your site’s search presence
• SEO Roadmap – Complete SEO audit and action plan tool

Common Mistakes to Avoid

• Making changes without testing in a staging environment first
• Ignoring the issue because it seems minor
• Applying fixes to production without proper backup
• Not verifying the fix was successful after implementation

The schema-specific ones: marking up content that is not visible on the page, running two plugins that both emit JSON-LD, and declaring a schema type you do not actually qualify for in the hope of a richer result. Google rewards accuracy and penalises the reach. Describe the page truthfully, validate it, and let the rich result follow.

Need More Help?

If you’re still having trouble fixing this issue, consider:

• Consulting with a WordPress developer or SEO specialist
• Checking the WordPress support forums for similar issues
• Reviewing your theme and plugin documentation
• Running a complete site audit with SEO Roadmap for a prioritized action plan

This guide is part of the SEO Roadmap knowledge base – your complete resource for WordPress SEO optimization.