Add BreadcrumbList schema — Windsurf
Raw URL paths in search results look ugly and get fewer clicks. BreadcrumbList schema replaces them with a clean hierarchy.
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:
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 BreadcrumbList schema 1. Add BreadcrumbList JSON-LD with itemListElement for each level of the page hierarchy.
Why this matters
Breadcrumbs in the SERP replace ugly URL paths like `/blog/2024/07/my-post-slug` with "Home > Blog > My Post". Cleaner, more clickable, more trustworthy.
Breadcrumbs also help Google understand your site structure — which pages are hubs, which are leaves — for better internal ranking distribution.
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_outlineMissing the position field in list items.
- error_outlineBreadcrumb items that do not reflect the actual page hierarchy.
- error_outlinePutting BreadcrumbList on the homepage — breadcrumbs start AFTER home.
How to verify the fix worked
- check_circleRich Results Test recognizes BreadcrumbList.
- check_circleSERP for a sub-page eventually shows the breadcrumb path.
Frequently asked questions
Match on-page breadcrumbs?expand_more
How many levels?expand_more
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 siteRelated Windsurf prompts
Add Organization schema — Windsurf
Prompt to add Organization JSON-LD with logo, sameAs links, and contact info to your homepage.
AI Search / GEOAdd JSON-LD structured data — Windsurf
Prompt to add Organization, Article, and FAQ JSON-LD to <head> — tells Google and AI crawlers exactly what your page represents.
Structured DataAdd WebSite schema with SearchAction — Windsurf
Prompt to add WebSite JSON-LD with a SearchAction — unlocks the sitelinks search box under your brand in Google.
Structured DataAdd FAQPage schema — Windsurf
Prompt to add FAQPage JSON-LD and enable expandable FAQ rich results in Google, plus AI citation signals.