GitHub Add to your assistant
Menu

aeo.schema-text-not-visible

WarningAEO audit

FAQPage, QAPage or HowTo structured data holds questions, answers or steps that are not in the page's HTML text.

What to change

Mark up only what the page shows: render every question, answer and step from the same data as the JSON-LD, or remove the items that are not on the page. Google's structured data guidelines forbid marking up content readers cannot see. If the page adds them with JavaScript, render them on the server too: most AI crawlers do not run JavaScript.

The documentation on developers.google.com

A finding of this rule on a page carries the exact edits for that page: the markup it quotes, and what to write instead.

When it runs

Runs on every AEO audit: of a page, a crawl, a build directory or HTML. A warning is a problem that costs a page ranking, clicks or citations. Each finding takes 5 points off the page's score.

The severity here is the rule's usual one: a finding can be raised or lowered when the page gives a reason.

Run it, or skip it

Check a page for this rule alone, after a fix for instance:

npx @rivi-software/agentic-seo-check aeo https://example.com --rule aeo.schema-text-not-visible

Or from an assistant, with the MCP tool seo_aeo_audit:

{
  "url": "https://example.com",
  "rules": [
    "aeo.schema-text-not-visible"
  ]
}

To leave it out of an audit, pass --disable aeo.schema-text-not-visible on the command, or disableRules: ["aeo.schema-text-not-visible"] to a tool.

All 32 rules