Advanced Breadcrumbs for Magento 2
Advanced Magento 2 Breadcrumbs Extension with Full Structured Data Support
The Magento 2 Breadcrumbs Extension enhances Magento’s default breadcrumb functionality with structured data support, advanced SEO controls, and flexible configuration options.
Built for merchants who want better search engine visibility and a clear navigation structure, this module ensures breadcrumbs are fully optimized for both users and search engines.
Instead of relying on Magento’s default breadcrumb output, the extension adds advanced schema markup, improved category path logic, and precise control over breadcrumb rendering.
Whether you manage a large product catalog or a complex category hierarchy, this lightweight module integrates seamlessly with Magento’s layout and theme system while ensuring accurate breadcrumb paths on product, category, and CMS pages.
Improve usability, strengthen internal linking, and enhance your SEO performance with optimized breadcrumb navigation built specifically for Magento 2 — now with an optional home icon, per-CMS-page control, and mobile-friendly truncation for Hyvä.
Improve Your SEO Structure
Add valid structured data (Schema.org BreadcrumbList) to help search engines better understand your site structure.
Clear Navigation
Display accurate breadcrumb paths based on the correct category hierarchy.
Better User Experience
Help customers understand where they are and easily navigate back — even on mobile, where long paths collapse neatly.
Built Specifically for Magento
Fully developed for Magento 2 and aligned with Magento layout XML and theme standards.
Optimized Breadcrumb Output for Categories, Products, and CMS Pages
The Magento 2 Breadcrumbs Module replaces and enhances Magento’s default breadcrumb logic to ensure consistent, SEO-friendly output across your entire store.
On category pages, the extension generates a clear hierarchical structure based on your category tree.
On product pages, the module ensures the correct category path is displayed, even when products are assigned to multiple categories.
CMS pages can also be enhanced with structured breadcrumbs, and you can now hide breadcrumbs on individual CMS pages with a single toggle in the CMS page SEO fieldset.
The extension respects Magento’s native routing and layout systems, ensuring compatibility with custom themes and Hyvä. On Hyvä storefronts, the middle breadcrumb items collapse behind an expand button on mobile when a path has more than three crumbs, keeping navigation tidy on small screens.
The result is a reliable breadcrumb structure that improves both user experience and technical SEO.
Automatic Structured Data Markup for Rich Results
The extension automatically adds valid Schema.org BreadcrumbList structured data to your pages.
This structured data helps Google and other search engines better understand your navigation structure, which can contribute to enhanced visibility in search results.
Instead of manually implementing JSON-LD or relying on theme customizations, the module dynamically generates optimized structured data based on the active breadcrumb path.
All markup is generated according to Google Rich Results guidelines and validated to prevent common schema errors — including omitting the item URL on the final breadcrumb, exactly as Google’s structured data guidelines require.
This results in better indexing, stronger internal linking signals, and improved search engine visibility for your Magento 2 store.
Full Control Over Breadcrumb Behavior in Magento 2
The Magento 2 Breadcrumbs Extension includes extensive configuration options within the Magento admin panel.
You can:
- Enable or disable breadcrumb output
- Enable or disable structured data markup
- Define primary category logic for products
- Exclude specific page types
- Customize breadcrumb labels
- Replace the “Home” label with an SVG house icon (Heroicons outline)
- Hide breadcrumbs on individual CMS pages
All settings are available under:
Stores > Configuration > Magmodules > Breadcrumbs
Every configuration group (except Debug) is now expanded by default, so all options are visible at a glance. No template overrides are required. The module operates entirely within Magento’s layout XML and block system, ensuring an upgrade-safe implementation.
Developers can extend or customize breadcrumb behavior through Magento’s standard dependency injection and plugin architecture.
Reliable and Lightweight Breadcrumb Architecture
The Magento 2 Breadcrumbs Module is built according to Magento best practices and a clean architectural approach.
Instead of overriding core functionality, the extension enhances Magento’s default breadcrumb block through observers and plugins. Breadcrumb generation now runs through dedicated page-type builder services (a shared BuilderInterface) instead of one monolithic provider, keeping the code clean and easy to extend.
Breadcrumb generation follows this process:
- A page request is processed
- Magento determines the active route
- The breadcrumb path is generated
- Structured data is added
- Breadcrumbs are rendered within the theme
Because the module avoids heavy overrides and relies on Magento’s native systems, it remains lightweight and compatible with custom themes and third-party modules. A dedicated CategoryLoader service caches categories at instance level to prevent duplicate repository calls, keeping rendering fast even on deep category trees.
With optimized output and clean schema markup, your Magento 2 store benefits from stronger internal linking, improved crawlability, and better SEO performance.
Benefits for Developers
- Clean Magento 2 plugin architecture
- No core overrides
- Dedicated page-type builder services (
BuilderInterface) - Instance-level category caching for performance
- Structured data generated dynamically
- Upgrade-safe implementation
- Compatible with Hyvä and custom themes
- Easy to extend through dependency injection
- Optional GraphQL support via companion module
Good to Know for Store Owners
- Improved breadcrumb visibility in Google
- Better internal linking structure
- Clear navigation for customers
- Optional home icon and per-CMS-page control
- Mobile-friendly breadcrumbs on Hyvä
- No manual schema implementation required
- Lightweight and performance-friendly
- Built specifically for Magento 2
Knowledgebase
All familiar Help articles
A list of the most frequently asked questions from the Advanced Breadcrumbs extension for Magento 2. We've tried our best to help you with the installation, configuration and troubleshooting. If you do not find the answer you were looking for, you can always send us a message through this form.
Installation articles
Installation using Composer (recommended) Installation using the Adobe Marketplace Install through FTP and SSHConfiguration
Configuration GuideChangelog 1.1.0 is released on 23 June 2026
Our plugins are regularly updated to ensure compatibility with the latest Magento release.
-
Features:
- Home icon option: replace "Home" text with SVG house icon (Heroicons outline)
- Hide breadcrumbs per CMS page: toggle in CMS page SEO fieldset via `hide_breadcrumbs` column
- Mobile truncation (Hyvä): middle breadcrumb items collapse with expand button on mobile when >3 crumbs Bugfixes:
- JSON-LD: removed `item` property from last breadcrumb `ListItem` per Google structured data guidelines Improvements:
- Refactored monolithic `BreadcrumbsProvider` into dedicated page-type builder services (`BuilderInterface`)
- Instance-level category caching via `CategoryLoader` service to prevent duplicate `CategoryRepository::get()` calls
- All admin config groups (except Debug) now expanded by default per module standards
- GraphQL support moved to separate companion module (`magmodules/magento2-advanced-breadcrumbs-graphql`) Minimum requirements:
- Magento 2.4.x
- PHP 8.1
-
Features:
- Server-side rendered breadcrumbs replacing Magento's default, with dual template support (Luma + Hyvä)
- Breadcrumb support for 11+ page types
- Four category selection strategies for products in multiple categories
- Per-product category override via primary_breadcrumb_category attribute
- Category weight and exclusion attributes for fine-grained breadcrumb path control
- Custom breadcrumb paths for CMS pages via JSON or pipe-separated format
- Schema.org BreadcrumbList JSON-LD structured data output for SEO
- Configurable separator, home crumb visibility, current page display, and custom labels per page type (store-scoped) Minimum requirements:
- Magento 2.4.x
- PHP 8.1
100% Unencrypted Code quality guaranteed.
Adobe Commerce Marketplace Approved
This extension is listed on the official Adobe Commerce Marketplace and has passed their review process for code quality, performance and security.
Adobe Marketplace approval means the extension follows Magento coding standards and integrates properly with the platform. Updates go through the same review process.
Magento Cloud Support
This extension is fully compatible with Adobe Commerce Cloud (Magento Cloud). It works with the read-only filesystem, the build and deploy pipeline and cloud-specific caching layers.
No additional configuration or workarounds are needed for cloud environments. The extension handles static content deployment and config management the same way as on-premise installations.
Private Composer Repo
After purchase you get access to a private Composer repository with personal credentials. Install and update the extension with a single composer command, just like any other dependency.
Your Composer credentials are available in your account dashboard. Updates are published to the repository as soon as a new version is released, so you always have access to the latest version.
12 May 2026
13 Apr 2026
11 Nov 2025
09 Sep 2025
05 Sep 2025
02 Sep 2025
30 Jul 2025
25 Jul 2025
18 Jul 2025
30 Jun 2025