Structured Data·Claude Code
Structured DataClaude Code

Add FAQPage schema — Claude Code

FAQ content without FAQPage schema misses the expandable rich result in Google and is harder for AI tools to cite as Q&A passages.

rocket_launch

Fixing this in Claude Code

Anthropic's official terminal coding agent

Claude Code can grep the whole codebase first, plan the change, then edit every affected file. Paste the prompt below into your Claude Code chat and the fix rolls out across the project in one pass.

Using a different tool? Pick your stack:

LovableCursorBoltv0ReplitWindsurfClaude CodeBase44

The prompt for Claude Code

Copy and paste this into your Claude Code chat exactly as-is.

Run Claude Code in the project root and make these exact changes, scanning the whole codebase first:

Add FAQPage schema

1. Wrap your Q&A content in FAQPage schema with mainEntity containing Question/Answer pairs.

Why this matters

FAQPage schema turns your FAQs into expandable accordions in Google results — taking 3-5x more pixel real estate than a normal result. In 2023 Google reduced FAQ rich results to "official" sites, but they still appear for well-marked pages with actual Q&A content.

ChatGPT, Claude, and Perplexity all read FAQPage schema to extract Q&A passages for direct citation. A page with FAQPage schema is significantly more likely to get quoted.

How to use this prompt in Claude Code

  1. 1. Open your Claude Code project.
  2. 2. Copy the prompt above with the copy button.
  3. 3. Paste into the Claude Code chat and send.
  4. 4. Review the diff, accept the changes, redeploy.
  5. 5. Verify the fix using the checklist below.

Common mistakes to avoid

  • error_outlineFAQPage schema on a page without visible FAQs — counts as spam.
  • error_outlineSame Q repeated across pages — only mark on the canonical page.
  • error_outlineOver 10 Q&As — Google typically shows only 3 in SERP; keep pages focused.

How to verify the fix worked

  • check_circleRich Results Test shows FAQPage type recognized.
  • check_circleSearch Console → Enhancements → FAQ — no errors.
  • check_circleSERP for your page sometimes shows expandable Q&As.

Frequently asked questions

Will Google always show rich FAQ results?expand_more
No. Google selectively displays them based on query and site authority. Having the schema is a prerequisite — display is not guaranteed.
How many Q&As per page?expand_more
Minimum 3. Sweet spot 4-6. Going above 10 rarely adds value.

Want all 34 prompts tailored to your Claude Code site?

Pantra scans your site in 10 seconds, detects the stack, and generates the exact prompts that apply — only the ones you actually need.

Scan my site

Related Claude Code prompts

AI Search / GEO

Add JSON-LD structured data — Claude Code

Prompt to add Organization, Article, and FAQ JSON-LD to <head> — tells Google and AI crawlers exactly what your page represents.

Structured Data

Add Organization schema — Claude Code

Prompt to add Organization JSON-LD with logo, sameAs links, and contact info to your homepage.

Structured Data

Add WebSite schema with SearchAction — Claude Code

Prompt to add WebSite JSON-LD with a SearchAction — unlocks the sitelinks search box under your brand in Google.

Structured Data

Add BreadcrumbList schema — Claude Code

Prompt to add BreadcrumbList JSON-LD so Google shows breadcrumbs instead of raw URLs in search results.

Learn more in the Glossaryarrow_forward