Advanced Breadcrumbs Quick Start Guide for Magento2

The Advanced Breadcrumbs module by Magmodules replaces Magento's default breadcrumb rendering with server-side HTML output, giving search engines reliable structured data without JavaScript dependencies. It adds JSON-LD BreadcrumbList schema out of the box, gives you full control over which page types display breadcrumbs, and lets you define exactly how category paths are resolved on product pages. This guide covers the essential configuration to get breadcrumbs working correctly on your store in about five minutes. For advanced options, refer to the full documentation.

Prerequisites

• Module installed and enabled via Composer
• Cache cleared after installation
• Admin access to Stores > Configuration > Magmodules > Advanced Breadcrumbs

Step 1: Enable the Module

1. Go to Stores > Configuration > Magmodules > Advanced Breadcrumbs > General
2. Set Enable Module to Yes
3. Click Save Config

Step 2: Configure Display Settings

Still in the configuration, open the Display Settings section.

Save after making your changes.

Step 3: Choose Your Page Types

Open the Page Types section. This controls on which page types breadcrumbs are rendered.

Enabled by default:

• Category Pages
• Product Pages
• CMS Pages

Optional — enable as needed:

• Search Results
• Cart
• Checkout
• Customer Account
• Wishlist
• Compare
• Contact
• 404 Page

Enable what fits your store, then save.

Step 4: Set Up Category Selection (Product Pages)

Open the Category Selection section. This controls how the module picks the category path shown on product pages when a product belongs to multiple categories.

Choose a Selection Strategy:

• Deepest Path — picks the most specific category (longest breadcrumb trail). Recommended for most stores.
• Shortest Path — picks the least specific category.
• Highest Weight — uses category weight values you assign manually in the category admin.
• First Assigned — mirrors Magento's default behavior.

Optionally enable Exclude Non-Anchor Categories to prevent dead-end category paths from appearing in breadcrumbs.

Save your configuration.

Step 5: Verify on Frontend

1. Flush the cache: System > Cache Management > Flush Magento Cache, or run bin/magento cache:flush
2. Visit a category page — breadcrumbs should appear above the product listing
3. Visit a product page — confirm the correct category path is shown
4. View the page source — breadcrumbs must be present in the raw HTML (not injected via JavaScript)
5. If JSON-LD is enabled (default), look for a <script type="application/ld+json"> tag containing BreadcrumbList in the source

If the breadcrumbs look correct in source, you're done.

Need More Help?

Documentation:

• All Help Articles - Complete documentation overview

Support:

• Contact Support - Get help from our team