Add FAQPage schema — Windsurf

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 Windsurf

Codeium agentic AI IDE with Cascade

Windsurf Cascade can walk the entire project and apply multi-file edits in one pass. Paste the prompt below into your Windsurf chat and the fix rolls out across the project in one pass.

Using a different tool? Pick your stack:

Lovable Cursor Bolt v0 Replit Windsurf Claude Code Base44

The prompt for Windsurf

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

Using Windsurf Cascade, apply these edits across the project in one pass:

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 Windsurf

1. Open your Windsurf project.
2. Copy the prompt above with the copy button.
3. Paste into the Windsurf chat and send.
4. Review the diff, accept the changes, redeploy.
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 Windsurf 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 Windsurf prompts

AI Search / GEO