SmartDuo Breadcrumb

SmartDuo Breadcrumb is an advanced breadcrumb management module for Drupal 11.3+ that gives site builders full control over breadcrumb trails without writing a single line of code. It provides a two-tier configuration system — set default patterns at the content-type level for consistency across your site, then override them on individual nodes whenever you need page-specific control. With a visual drag-and-drop builder, Media Library icon support, token-powered dynamic labels, and flexible link destinations (internal paths, external URLs, anchored links, token, and ), SmartDuo Breadcrumb handles everything from simple corporate sites to complex multi-section portals.

Features

Multi-Level Configuration

• Configure default breadcrumb patterns at the content-type level for site-wide consistency
• Override breadcrumbs on individual nodes when you need page-specific control
• Choose between System Default (path-based) or Custom breadcrumb patterns at each level

Visual Breadcrumb Builder

• Intuitive admin interface for composing custom breadcrumb segments — no code required
• Add, remove, and reorder segments with drag-and-drop
• Each segment supports a label, link destination, optional icon, and display mode

Flexible Link Destinations

• Internal paths: /node/123, /about, /articles
• External URLs: https://example.com
• Anchored links: /page#section (when enabled in global settings)
• Front page: /
• No Link Support: <nolink>
• Token Support: [node:title]

Icon Support via Media Library

• Select icons for any breadcrumb segment through the standard Media Library widget
• Three display modes per segment: text only, icon only, or both
• Optionally replace the global "Home" label with a custom icon

Token Integration

• Use Drupal tokens in breadcrumb labels for dynamic, content-aware breadcrumbs
• Supports node fields, taxonomy terms, user data, dates, and more
• Examples: [node:title], [node:field_category], [node:author:name]
• Token browser available when the Token module is installed

Global Settings

• Include or exclude the front page segment and current page segment (applies to System Default mode only)
• Replace the front page label with a custom icon (applies to System Default mode only)
• Capitalize the first letter of each word (configurable ignore list)
• Automatically remove duplicate segments
• Built-in caching with configurable max-age

Security & Performance

• XSS prevention — all labels are stripped of HTML tags
• Input validation on all user-supplied data (length limits, type checks, path validation)
• Configurable cache duration for production-ready performance
• Optional error and generation logging for troubleshooting

Post-Installation

1. Configure Global Settings

Navigate to /admin/config/user-interface/sd-breadcrumb to set up:

• Front page and current page inclusion
• Front page segment title (default: "Home") and optional icon replacement
• Capitalization and formatting rules
• Cache and logging options

2. Configure Content-Type Patterns

On the same settings page, a table lists all content types. For each type you can:

• Enable or disable breadcrumbs entirely
• Select System Default (path-based) or Custom Pattern mode
• Click Add/Edit Pattern to open the visual breadcrumb builder

3. Create Custom Patterns (optional)

In the pattern editor, use the visual builder to compose segments. Each segment has:

• Label — static text or tokens like [node:title]
• Link — any internal path, external URL, or anchor
• Icon — select from the Media Library
• Display mode — text only, icon only, or both

4. Set Node-Level Overrides (optional)

On any node edit form, open the Breadcrumb Settings section to:

• Disable breadcrumbs for that specific node
• Switch from automatic (content-type pattern) to a node-specific pattern
• Build a custom breadcrumb using the same visual builder

Field Display

The module automatically adds breadcrumb configuration fields to all content types. To adjust their visibility on node forms, visit /admin/structure/types/manage/[TYPE]/form-display.

Requirements

Required

• Drupal 11.3 or higher
• PHP 8.4.1 or higher
• Media module (core)
• Media Library module (core)

No external libraries or third-party services are needed — all functionality is built on Drupal core APIs.

Recommended Modules

Token — Adds a token browser to the breadcrumb builder, making it much easier to discover and insert dynamic tokens. Not required, but strongly recommended.

Pathauto — Pairs well with SmartDuo Breadcrumb for sites that need consistent, SEO-friendly URL aliases alongside matching breadcrumb trails.

Common Use Cases

• Corporate site: Home → About Us → Our Team → [Employee Name]
• E-commerce: Home → [Category] → [Subcategory] → [Product Name]
• News or blog: Home → News → [Article Category] → [Article Title]
• Documentation portal: Docs → [Guide] → [Section] → Current Page

Similar Projects

Easy Breadcrumb — A simpler, configuration-only breadcrumb module. SmartDuo Breadcrumb extends this concept with a visual builder, per-node overrides, icon support, and content-type-level patterns.

Custom Breadcrumbs — An older module that may not be actively maintained for recent Drupal versions. SmartDuo Breadcrumb is built from the ground up for Drupal 11+ with a modern admin UI.

Menu Breadcrumb — Generates breadcrumbs strictly from menu structure. SmartDuo Breadcrumb offers both automatic path-based breadcrumbs and fully custom patterns with tokens and icons.

What sets SmartDuo Breadcrumb apart:

• Two-tier configuration — set defaults at the content-type level, override on individual nodes
• Visual builder — compose breadcrumbs through the UI without writing code or config
• Media Library icons — add visual elements to any breadcrumb segment
• Universal link support — internal paths, external URLs, anchored links
• Token support — dynamic labels that adapt to the content being viewed
• Modern codebase — Drupal 11.3+ and PHP 8.4+ compatible

Accessibility

SmartDuo Breadcrumb follows WCAG guidelines:

• Semantic <nav> element with proper ARIA labels
• Keyboard-navigable breadcrumb links
• Alt text preserved for icon-only segments

Supporting This Module

If SmartDuo Breadcrumb is useful to your project, consider:

• ⭐ Starring the project on Drupal.org
• 🐛 Reporting issues to help improve quality
• 📝 Writing a review so others can discover it
• 🤝 Contributing patches, features, or documentation

Documentation & Support

• README — Comprehensive feature guide included with the module
• Issue queue: https://www.drupal.org/project/issues/sd_breadcrumb