Skip to content
atlookup

BreadcrumbList Schema Items Are Incomplete

Google's breadcrumb-rich-result requires every itemListElement to have both position (number) and name (string).

warning Impact: medium SCHEMA_BREADCRUMB_INCOMPLETE 2 min read Updated

Why it matters

Google's breadcrumb-rich-result requires every itemListElement to have both position (number) and name (string). Incomplete items mean the breadcrumb trail is rejected entirely — the SERP shows the bare URL instead of your nested path.

Schedule a fix in your next sprint. Warnings won't block your site but they consistently leave performance on the table. Estimated SEO impact: medium — measurable effect on click-through or relevance.

How to fix

  • Verify each ListItem has "@type": "ListItem", "position": <n>, and "name": "<text>"
  • The first item should be position 1, increasing sequentially
  • For all but the last item, include "item": "<url>" pointing to that breadcrumb level's URL

Common causes

If the rule is firing across many pages, the root cause is almost always one of these:

  • Schema fields filled with placeholder values during template development that survived to production.
  • Required nested fields silently dropped when the upstream API response shape changes.
  • Multiple schema types declared on one page where a single canonical type is expected.
  • Mismatched values between visible HTML and JSON-LD trigger Google's "manipulative" filter.

Anti-patterns to avoid

Even with the best intentions, these "fixes" make the issue worse — recognise them so you don't ship them:

  • Marking up content that doesn't actually exist on the page.
  • Different visible price vs schema price.
  • Declaring a Product schema for a category listing page.

How atlookup detects this

Our crawler renders each page with a real headless browser, then extracts every JSON-LD / microdata block and validates required + recommended properties against Schema.org and Google's Rich Results guidelines. Pages where the rule fires for breadcrumblist schema items are incomplete are flagged on the report.

If you'd like to see this rule fire on your own site, run a free 60-second audit — every page is reported with the exact lines that triggered it.

Tools to verify the fix

Once you've applied the fix, double-check with these external validators:

Frequently asked questions

Why does BreadcrumbList Schema Items Are Incomplete matter for SEO?

Google's breadcrumb-rich-result requires every itemListElement to have both position (number) and name (string). Incomplete items mean the breadcrumb trail is rejected entirely — the SERP shows the bare URL instead of your nested path.

How do I fix breadcrumblist schema items are incomplete?

Verify each ListItem has "@type": "ListItem", "position": <n>, and "name": "<text>" The first item should be position 1, increasing sequentially For all but the last item, include "item": "<url>" pointing to that breadcrumb level's URL

Is this a critical SEO issue?

Schedule a fix in your next sprint. Warnings won't block your site but they consistently leave performance on the table. Estimated SEO impact: medium — measurable effect on click-through or relevance.

How does atlookup detect breadcrumblist schema items are incomplete?

Our crawler renders each page with a real headless browser, then extracts every JSON-LD / microdata block and validates required + recommended properties against Schema.org and Google's Rich Results guidelines. Pages where the rule fires for breadcrumblist schema items are incomplete are flagged on the report.

How long does it take to fix?

5–15 minutes per page. Most teams batch similar issues across templates so the per-page time goes down at scale.