Technical

Common Schema Markup Errors That Silently Block AI Citation

A page can carry a schema tag and still be invisible to AI retrieval, because the markup fails validation, contradicts the visible content, or is missing a required property. Here are the seven errors that show up most often in CiteRank audits, and how to fix each one.

Neil Walsh·July 2026·7 min read

Schema markup errors are faults in a page's structured data, invalid JSON-LD syntax, properties that contradict the visible content, missing required fields, or duplicate and conflicting blocks, that quietly stop AI engines from trusting or extracting a page even when a schema tag is technically present. This is the gap that trips up most sites: the presence of a script tag with type application/ld+json is not the same thing as a working, trustworthy piece of structured data, and AI retrieval systems are far less forgiving of the difference than most site owners assume.

CiteRank audits regularly find pages that pass a casual glance, there is clearly a schema block in the source, but fail on the details that determine whether an AI engine treats that markup as reliable. The following seven errors account for the large majority of schema-related citation problems we see, roughly in order of how often they appear.

Why a 'present' schema tag is not the same as a working one

Retrieval-augmented AI systems use structured data as a trust and extraction shortcut. FAQPage schema tells the model exactly where a question ends and an answer begins. Article schema tells it who wrote a page and when it was last checked. When that markup is malformed or inconsistent with the page itself, the model does not politely ignore it and fall back to reading the visible text as if no schema existed. In several documented cases, invalid or contradictory schema performs worse than no schema at all, because it is treated as a quality signal violation rather than a neutral absence of information.

Invalid schema is not a harmless no-op. A JSON-LD block that fails to parse, or that describes content not actually present on the page, can suppress citation confidence below the baseline you would have with no structured data at all.

The 7 schema errors that block AI citation most often

1. Invalid JSON-LD syntax

A single trailing comma, an unescaped quotation mark inside a text field, or a missing closing brace is enough to make an entire JSON-LD block fail to parse. When that happens, every schema type in the block, not just the malformed line, is discarded by any parser that requires valid JSON before reading a single property. This is the single most common error CiteRank finds, and it usually traces back to a CMS field where an editor pasted quote characters or an apostrophe straight from a word processor without escaping them.

2. Schema that contradicts the visible page content

Schema describing an author, a price, a rating, or a set of FAQ answers that do not match what a visitor actually sees on the page is a direct violation of Schema.org and Google's structured data guidelines, and it is exactly the kind of inconsistency that AI retrieval systems are increasingly built to detect. A common version of this error: a marketing team updates a price or a headline on the page but the JSON-LD block, generated separately or cached upstream, keeps serving the old value.

3. Missing required properties

Every schema type has a small set of properties that are required for validity, not merely recommended. FAQPage needs a name and acceptedAnswer for every entry. Article needs headline, author, and datePublished. Product needs name and, for AggregateRating to be eligible, a ratingValue and reviewCount. Omitting any of these does not just cost you a rich result in Google, it gives an AI parser an incomplete object it cannot confidently extract from, which is often treated as equivalent to no markup for that entity.

4. Duplicate or conflicting schema blocks

Pages built with a CMS plugin and a manually added JSON-LD block frequently end up with two Organization or two Article schemas describing the same entity with different values, one plugin-generated, one hand-coded and stale. When a parser encounters two schema objects of the same type describing the same page with contradictory field values, it has no reliable way to decide which one to trust, and the safest assumption from the model's side is to trust neither.

5. Using the wrong schema type for the content

FAQPage schema applied to a page that is not actually a set of questions and answers, or HowTo schema applied to a narrative blog post with no discrete steps, is a mismatch that both Google's guidelines and AI retrieval heuristics penalise. The fix is not to remove structured data from the page, it is to match the schema type to what the content genuinely is: Article for narrative content, HowTo only for genuine step sequences, FAQPage only for genuine question and answer pairs.

6. Stale dateModified and datePublished fields

A dateModified field that has not changed in two years on a page that has, in fact, been edited several times is a freshness signal working against you. AI engines weight recency heavily when choosing which of several similar sources to cite, and a schema date field that contradicts your own content history (or the page's HTTP Last-Modified header) undermines the freshness case your content is otherwise making.

7. Missing author and Person markup

Article and BlogPosting schema with an author field that is a bare string, rather than a full Person object with a name, url, and ideally sameAs links to an author bio page or professional profile, forfeits one of the strongest E-E-A-T signals available to structured data. This error is easy to miss because the page still validates; a string author value is syntactically legal, it is simply far weaker evidence of who actually wrote the piece.

How to audit your site for these errors

  1. Paste every unique template's JSON-LD into Google's Rich Results Test (search.google.com/test/rich-results) and read every warning, not just the errors; warnings often flag missing recommended fields that AI parsers treat as required in practice
  2. Cross-check with the Schema.org validator (validator.schema.org), which checks specification compliance independently of Google's rich result eligibility rules and catches issues Google's tool does not surface
  3. Run the same URL through Bing's markup validator (bing.com/webmaster/tools/markup-validator) if any AI engine you care about, such as Copilot, reads Bing's index
  4. Manually compare every value in the JSON-LD block against the rendered page: author name, price, rating, publish and modified dates, and every FAQ question and answer
  5. Search your site for duplicate schema types on the same page, most commonly caused by a plugin and a manual implementation both firing on the same template
  6. Re-run a CiteRank audit after fixing each template, since the structured data check will confirm whether the fix actually resolved the underlying signal, not just the validator warning

Fixing errors: what to prioritise first

Fix invalid JSON-LD syntax first, since a parse failure discards the entire block and makes every other fix on that page moot until it is resolved. After that, prioritise contradictions between schema and visible content, since these are quality-signal violations rather than simple omissions. Missing optional-but-valuable properties, such as full Person objects for authors, are the lowest-priority fix; valuable, but they improve an already-working schema block rather than repair a broken one.

Build a one-page checklist per template (homepage, blog post, product page, FAQ page) listing the required properties for that template's schema type, and review it whenever the template changes. Most schema errors are introduced by a template or CMS change made months after the original correct implementation, not by the initial rollout.

Structured data is not a set-and-forget technical task. Content management systems change fields, marketing teams update copy without touching the JSON-LD generator, and plugins update in ways that silently alter output. Treat a schema audit as a recurring item, quarterly at minimum, alongside your other AEO metrics tracking, not a one-time implementation you can forget once the validator shows a pass.

Frequently asked questions

Can invalid schema markup hurt my AI citation rate more than having no schema at all?

Yes, in several documented cases. A JSON-LD block that fails to parse, or that visibly contradicts the page's actual content, can be treated as a quality-signal violation rather than a neutral absence of data, which pushes citation confidence below the baseline a page with no structured data would have.

What is the single most common schema error?

Invalid JSON-LD syntax, most often a trailing comma, an unescaped quotation mark or apostrophe pasted from a word processor, or a missing closing brace. Any of these causes the entire schema block to fail parsing, discarding every schema type inside it, not just the malformed line.

Does Google's Rich Results Test catch every schema error that affects AI citation?

No. It validates against Google's specific rich result eligibility requirements, which is a narrower and stricter set of rules than general schema.org validity. Pair it with the Schema.org validator at validator.schema.org, which checks specification compliance independently, to catch issues Google's tool does not flag.

Why does my schema still show as valid even though it contradicts my page content?

Because syntax validity and content accuracy are separate checks. A validator confirms your JSON-LD parses correctly and includes the required properties; it has no way to know that the price, author, or FAQ answer in your markup no longer matches what a visitor sees. That comparison has to be done manually or with a dedicated content-consistency audit.

How often should I re-audit schema markup for errors?

Quarterly at minimum, and immediately after any CMS, plugin, or template update that touches a page type carrying structured data. Most schema errors are introduced months after a correct initial implementation, when a field is edited, a plugin updates, or a template is redesigned without anyone checking the JSON-LD output.

Is a string author value in Article schema an error?

It is syntactically valid but a missed opportunity rather than a hard error. A bare string author name validates correctly, but a full Person object with a name, url, and sameAs links to a bio page or professional profile is a substantially stronger E-E-A-T signal and is worth the extra implementation effort on any page where author credibility matters.

Can duplicate schema blocks on the same page cause citation problems?

Yes. When a CMS plugin and a manually added script both generate schema for the same entity, such as two Organization blocks with different values, a parser has no reliable way to decide which is authoritative. The safest assumption from the model's side is often to trust neither, which functionally removes the benefit of having schema at all.

Should I remove FAQPage schema if my page is not really a set of questions and answers?

Yes. Applying FAQPage schema to content that is not genuinely structured as questions and answers is a type mismatch that both Google's guidelines and AI retrieval heuristics penalise. Use Article schema for narrative content instead, and reserve FAQPage, HowTo, and other specific types for pages whose content genuinely matches that structure.

Free tool

See your AEO score in seconds

Paste your URL and get a full audit across all 9 AEO signals - schema, crawlers, E-E-A-T, and more.

Audit my site - it's free

Related reading

Technical

Why Schema.org markup is the single biggest lever for AI citation

May 2026
Technical

Is your robots.txt accidentally blocking ChatGPT and Claude?

May 2026