# Breadcrumb Schema Duplicate Detection Fix Summary **Last Updated:** 2026-01-20 ## Problem Google Search Console was detecting **2 breadcrumb elements** per blog post, causing confusion and potential SEO issues. Schema validators showed only 1 breadcrumb, creating a discrepancy. ## Root Cause Blog posts had **duplicate breadcrumb schema** in two formats: 1. **JSON-LD BreadcrumbList** - Generated by `blog-schema-generator.php` and output in `` section 2. **Microdata BreadcrumbList** - Output by `Breadcrumbs.php` component using `itemscope`, `itemtype`, and `itemprop` attributes Both were present on the same page, causing GSC to detect duplicates. ## Solution Implemented ### Changes Made 1. **Disabled Microdata in Breadcrumbs Component** (blog pages only) - **File**: `v2/pages/blog/post.php` (line 432) - **Change**: Set `$include_schema = false` before including Breadcrumbs component - **Reason**: JSON-LD breadcrumb already provided via `render_blog_schema()` 2. **Disabled Microdata in Breadcrumbs Component** (topic hub pages) - **File**: `v2/pages/blog/topic-hub.php` (line 138) - **Change**: Set `$include_schema = false` before including Breadcrumbs component - **Reason**: JSON-LD breadcrumb already provided via `render_blog_schema()` ### Why This Approach - **JSON-LD is preferred**: Google's recommended format for structured data - **Single source of truth**: One schema format per page prevents confusion - **No visual impact**: Breadcrumb navigation still works (schema is for SEO only) - **Isolated change**: Only affects blog pages, no impact on other pages ## Files Modified 1. `v2/pages/blog/post.php` - Disabled Microdata schema 2. `v2/pages/blog/topic-hub.php` - Disabled Microdata schema 3. `docs/seo/BREADCRUMB_SCHEMA_BEST_PRACTICES.md` - New comprehensive guide 4. `docs/content/blog/reference/COMPONENT_API.md` - Updated Breadcrumbs documentation 5. `.cursor/rules/blog-templates-components.mdc` - Updated component usage patterns 6. `.cursor/rules/blog-templates-seo.mdc` - Added breadcrumb schema strategy 7. `v2/scripts/blog/test-breadcrumb-schema.php` - New validation script ## Testing Results ### JSON-LD Schema Generation - ✓ Blog posts: 1 BreadcrumbList schema generated - ✓ Topic hubs: 1 BreadcrumbList schema generated - ✓ Schema structure: Valid (all required fields present) ### Microdata Schema Output - ✓ Blog posts: Microdata correctly disabled (`$include_schema = false`) - ✓ Topic hubs: Microdata correctly disabled (`$include_schema = false`) - ✓ Component respects parameter: No Microdata attributes when disabled ### Visual Breadcrumbs - ✓ Navigation links: Present and functional - ✓ Current page display: Works correctly - ✓ Separators: Display correctly - ✓ Accessibility: ARIA labels preserved ## Expected Results ### Before Fix - GSC: "2 valid items detected" for Breadcrumbs - Page source: Both JSON-LD and Microdata BreadcrumbList present - Schema validator: May show 1 (parses JSON-LD first) or 2 ### After Fix - GSC: "1 valid item detected" for Breadcrumbs (after Google recrawls) - Page source: Only JSON-LD BreadcrumbList present - Schema validator: Shows 1 BreadcrumbList element - Visual breadcrumbs: Still functional (no schema attributes, but navigation works) ## Validation ### Test Script ```bash # Test specific post php v2/scripts/blog/test-breadcrumb-schema.php ratgeber arbeitsstunden-pro-monat # Test sample of posts php v2/scripts/blog/test-breadcrumb-schema.php --sample 10 # Test all posts php v2/scripts/blog/test-breadcrumb-schema.php --all ``` ### Manual Validation 1. View page source - search for `"@type": "BreadcrumbList"` (should find 1) 2. View page source - search for `itemtype="BreadcrumbList"` (should find 0 for blog pages) 3. Google Search Console - URL Inspection should show 1 breadcrumb item 4. Schema Markup Validator - Should show 1 BreadcrumbList element ## Impact on Other Pages **No Impact**: - Breadcrumbs component only used on blog pages (`post.php`, `topic-hub.php`) - Other pages don't use this component - Shared includes (`head.php`, `header.php`) unaffected - Visual breadcrumb navigation unchanged ## Next Steps 1. **Deploy changes** to production 2. **Wait for Google recrawl** (1-2 weeks) 3. **Monitor GSC** - Check "Breadcrumbs" section in URL Inspection 4. **Validate fix** - Should show "1 valid item detected" instead of 2 5. **Run test script** periodically to ensure no regressions ## Related Documentation - [Breadcrumb Schema Best Practices](./BREADCRUMB_SCHEMA_BEST_PRACTICES.md) - [Blog Component API](../../content/blog/reference/COMPONENT_API.md) - [Blog Templates SEO Rules](../../.cursor/rules/blog-templates-seo.mdc) ## References - [Google: Breadcrumb Structured Data](https://developers.google.com/search/docs/appearance/structured-data/breadcrumb) - [Google: Structured Data Intro](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data)