Skip to content

fix: omit unlinked breadcrumb crumbs from JSON-LD - #24

Merged
larbish merged 1 commit into
mainfrom
fix/breadcrumb-jsonld-missing-item
Aug 18, 2026
Merged

fix: omit unlinked breadcrumb crumbs from JSON-LD#24
larbish merged 1 commit into
mainfrom
fix/breadcrumb-jsonld-missing-item

Conversation

@farnabaz

Copy link
Copy Markdown
Collaborator

Summary

  • Google Search Console reported a critical Breadcrumbs structured data issue: Missing field item (in itemListElement).
  • Non-page section nodes (page: false) intentionally have no path for unlinked UI crumbs; those were still emitted into BreadcrumbList JSON-LD without item.
  • Filter those crumbs out of structured data and centralize BreadcrumbList construction in breadcrumbListLd, which always requires an absolute item URL.

Test plan

  • pnpm test (121 tests)
  • After deploy, re-validate a docs page URL in Rich Results Test / GSC Breadcrumbs report
  • Confirm itemListElement entries each include position, name, and item

Google Search Console flags BreadcrumbList entries missing the required
`item` field. Non-page section nodes (page: false) have no URL, so drop
them from structured data and always emit `item` via breadcrumbListLd.
@vercel

vercel Bot commented Aug 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
comark-docs-playground Ready Ready Preview Aug 18, 2026 12:22pm

@pkg-pr-new

pkg-pr-new Bot commented Aug 18, 2026

Copy link
Copy Markdown
npm i https://pkg.pr.new/comarkdown/comark-docs@24

commit: 30ee869

@larbish
larbish merged commit 9be95bf into main Aug 18, 2026
5 checks passed
@larbish
larbish deleted the fix/breadcrumb-jsonld-missing-item branch August 18, 2026 12:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants