Advanced Breadcrumbs voor Magento 2
Test out this module for Free
Advanced Breadcrumbs
Check your email
We've sent a confirmation link. Click it to spin up your demo.
Setting up your demo...
This usually takes a few minutes. You can close this modal or wait for the result — we'll also send you an email when it's ready.
You're in the queue
Position: #
All demo slots are currently in use. You'll receive an email as soon as your demo is ready.
Your demo is ready!
Verloopt:
Credentials have also been sent to your email.
Er ging iets mis
We couldn't set up your demo. Please try again or contact support.



Advanced Breadcrumbs voor Magento 2
Server-side breadcrumbs met bijpassende structured data
Advanced Breadcrumbs rendert het kruimelpad van je Magento 2-webshop op de server en voegt een Schema.org BreadcrumbList in JSON-LD toe die hetzelfde pad volgt. De module heeft een eigen template voor Luma en voor Hyvä.
Bij een product in meerdere categorieën bepaal jij welk pad er staat: de categorie waar de klant vandaan kwam, een vaste categorie per product, een gewicht per categorie of een selectiestrategie.
Sinds versie 1.2.0 kan een CMS-pagina een eigen kruimelpad krijgen, bijvoorbeeld Home > Service > Returns. Bezoekers en zoekmachines zien de pagina dan onder de sectie waar ze bij hoort.

Server-side rendering
Het kruimelpad zit in de HTML die Magento teruggeeft, met één template voor Luma en één voor Hyvä.
JSON-LD die klopt met het pad
Een Schema.org BreadcrumbList wordt opgebouwd uit dezelfde kruimels die de bezoeker ziet.
Eén pad per product
Het navigatiepad, een override per product, gewichten per categorie en vier strategieën bepalen welke categorie er staat.
Eigen kruimelpad per CMS-pagina
Vul de kruimels van een CMS-pagina zelf in, of verberg de breadcrumbs op die pagina.
Elf paginatypes
Kies waar breadcrumbs verschijnen, van categoriepagina's tot de winkelwagen en de 404-pagina, met je eigen labels.
Inklappen op mobiel met Hyvä
Een pad met meer dan drie kruimels klapt op kleine schermen in achter een "…"-knop.
Het juiste categoriepad op productpagina's
Een product dat in meerdere categorieën staat, heeft meerdere mogelijke kruimelpaden. Met "Respect Navigation Path" op "Yes", de standaardwaarde, toont de productpagina de categorie waar de klant vandaan kwam, mits het product aan die categorie is gekoppeld. Een klant die via Furniture > Chairs kwam, ziet dat pad.
Is er geen navigatiepad, bijvoorbeeld na een zoekopdracht of een directe link, dan kiest "Selection Strategy" de categorie: "Deepest Path (most specific)", "Shortest Path (least specific)", "Highest Weight" of "First Assigned (legacy behavior)". Standaard staat "Deepest Path (most specific)" aan, zodat het pad de meest specifieke plek in de catalogus laat zien.
"Exclude Non-Anchor Categories" laat categorieën weg die niet als anchor zijn ingesteld. Deze instellingen zijn beschikbaar op default- en websiteniveau.


Een vaste categorie per product en een gewicht per categorie
Geeft de strategie niet het pad dat je wilt, dan stuur je bij. Op het product toont het veld "Primary Breadcrumb Category" in de sectie "Search Engine Optimization" de actieve categorieën waaraan het product is gekoppeld, elk met het volledige pad. Kies er één en de automatische keuze gebruikt die categorie voor dit product. Wordt die categorie later uitgezet of verwijderd, dan valt de module terug op gewichten en strategie.
Op de categorie bepaalt "Breadcrumb Weight" de voorrang: de categorie met het hoogste gewicht wint, welke strategie er ook is gekozen. Een gewicht van 0 volgt de strategie. Een negatief gewicht haalt de categorie uit de automatische keuze, net als "Exclude from Breadcrumbs". Zo blijft een categorie als Sale buiten de automatische keuze en toont een product zijn plek in de catalogus.
De volgorde is: override op het product, dan gewogen categorieën, dan de strategie. Standaard gaat het navigatiepad van de klant daar nog voor. Zet "Navigation Overrides Product Override" op "No" om de vaste categorie van het product te laten winnen.
BreadcrumbList structured data in JSON-LD
Met "Enable JSON-LD" op "Yes", de standaardwaarde, voegt de module een BreadcrumbList in JSON-LD toe aan elk kruimelpad dat ze opbouwt. De lijst komt uit dezelfde kruimels als het zichtbare pad, dus je schrijft en onderhoudt geen schema-markup in je theme.
Elk ListItem heeft een position, een name en een item met de URL. Het laatste item, de pagina zelf, heeft geen item; Google vraagt dat bij het laatste item niet. Een kruimel in het midden zonder link krijgt de URL van de huidige pagina.
"Include Home in JSON-LD" bepaalt of de Home-kruimel in de lijst staat. Op Luma bevat de HTML van het pad ook Schema.org-microdata; het Hyvä-template geeft alleen JSON-LD. Beide instellingen zijn beschikbaar op default- en websiteniveau.


Een eigen kruimelpad per CMS-pagina
Een CMS-pagina krijgt normaal één kruimel: de titel. Sinds versie 1.2.0 heeft het CMS-paginaformulier een sectie "Advanced Breadcrumbs" waarin je "Use Custom Breadcrumb Trail" aanzet en het pad zelf invult. Elke rij is een kruimel met een "Label" en een "URL". Met "Add Crumb" voeg je een rij toe en je sleept rijen in de juiste volgorde.
Een relatieve URL zoals /customer-service wordt aangevuld met de URL van de winkel. Een URL die met http of https begint, blijft zoals hij is. De laatste rij is de pagina zelf en wordt nooit een link, en rijen zonder label worden overgeslagen. Met de rijen Service en Returns ziet de bezoeker Home > Service > Returns, en de JSON-LD bevat dezelfde items met absolute URL's.
"Hide Breadcrumbs" in dezelfde sectie haalt het kruimelpad en de JSON-LD van die pagina, ook als er een eigen pad is ingevuld.
Home-icoon, label en scheidingsteken
Onder "Display Settings" stel je per store view in hoe het kruimelpad eruitziet. "Show Home Crumb" zet Home als eerste kruimel neer en "Home Label" bepaalt de tekst, zodat elke taal een eigen woord krijgt. "Use Home Icon" vervangt het woord door een SVG-icoon van een huisje. Het label blijft als aria-label in de link staan, zodat schermlezers het nog voorlezen.
"Separator Character" is het teken tussen de kruimels, met een maximum van vijf tekens. Standaard is dat ">". "Show Current Page" bepaalt of de productnaam het pad op een productpagina afsluit, zonder link.
Elk veld heeft "Use system value" om terug te gaan naar de standaardwaarde.


Korte kruimelpaden op mobiel met Hyvä
Een diep categoriepad neemt op een telefoon meerdere regels in. Op een Hyvä-store view wordt een pad met meer dan drie kruimels onder het md-breekpunt ingekort: de eerste en de laatste kruimel blijven zichtbaar en de kruimels ertussen staan achter een "…"-knop. Eén tik toont het volledige pad. De knop heeft het aria-label "Show full breadcrumb path".
Op grotere schermen staat altijd het volledige pad. De module controleert per store view of het theme Hyvä is en kiest het bijpassende template, dus een installatie met zowel Luma- als Hyvä-store views vraagt geen extra configuratie. Het inklappen zit in het Hyvä-template; Luma toont het volledige pad.
Breadcrumbs op elf paginatypes
"Enable Breadcrumbs On" toont de paginatypes die de module afhandelt: "Category Pages", "Product Pages", "CMS Pages", "Search Results", "Shopping Cart", "Checkout", "Customer Account", "Wishlist", "Compare Products", "Contact Page" en "404 Page". Na installatie zijn de eerste drie geselecteerd en de rest zet je zelf aan. "Customer Account" dekt ook de bestel-, adres- en nieuwsbriefpagina's van het account.
Onder "Custom Labels" stel je per store view de tekst van de kruimel in voor zoek-, winkelwagen-, checkout-, account-, verlanglijst-, vergelijk-, contact- en 404-pagina's.
"Fallback for Other Pages" staat standaard aan. Pagina's van andere modules die kruimels toevoegen met de addCrumb()-methode van Magento, worden dan met het template van deze module getoond. Zo ziet het kruimelpad er in de hele winkel hetzelfde uit.

Nieuw in versie 1.2.0
CMS-pagina's kunnen een eigen kruimelpad krijgen: zet "Use Custom Breadcrumb Trail" aan en vul rijen in met een "Label" en een "URL".
Rijen voeg je toe met "Add Crumb" en zet je in volgorde door te slepen.
Het eigen pad staat ook in de JSON-LD, waarbij relatieve URL's absoluut worden gemaakt.
"Hide Breadcrumbs" en het eigen pad staan in een eigen sectie "Advanced Breadcrumbs" op het CMS-paginaformulier.
getCmsBreadcrumbs() geeft het eigen pad ook terug, zodat een headless storefront hetzelfde pad krijgt.
Opgelost: antwoorden in de pop-ups van de admin worden ge-escaped en de logviewer werkt weer.
Advanced Breadcrumbs voor Magento 2: technische details voor developers en webshopeigenaren
De voordelen voor developers
- De frontend vervangt
Magento\Theme\Block\Html\Breadcrumbsmet een preference. Staat de module uit of heeft ze geen pad voor een pagina, dan geeft het block de eigen uitvoer van Magento terug. Er zijn geen template-overrides in het theme nodig. - Elk paginatype heeft een eigen builder die
BuilderInterfaceimplementeert. De builders worden aangeleverd via het argumentbuildersinetc/di.xml, zodat je de builder van een paginatype vanuit je eigen module kunt vervangen. BreadcrumbsProviderInterfacegeeft het pad voor elk product, elke categorie of elke CMS-pagina metgetProductBreadcrumbs(),getCategoryBreadcrumbs()engetCmsBreadcrumbs().getJsonLdFor()zet een pad om naar JSON-LD.- GraphQL voor headless storefronts zit in de aparte module
magmodules/magento2-advanced-breadcrumbs-graphql, die hetzelfde pad teruggeeft als de winkel. CategoryLoaderhoudt geladen categorieën per instantie in het geheugen, zodat een categorie in het pad niet twee keer uit de repository wordt opgehaald.- Het Hyvä-template wordt gekozen via de
CurrentTheme-service van Hyvä en de module registreert haar templates voor de Tailwind-build ophyva_config_generate_before. - "Debug Mode" schrijft debugregels naar
debug.log. Fouten komen altijd inerror.log. - Vereist PHP 8.1 of hoger en Magento 2.4.x.
Goed om te weten voor webshopeigenaren
- Na installatie staat de module uit. Zet "Enable Module" aan onder "Stores" > "Configuration" > "Magmodules" > "Advanced Breadcrumbs".
- Eenmaal aan zijn breadcrumbs actief op categorie-, product- en CMS-pagina's en staat JSON-LD aan. De andere acht paginatypes voeg je zelf toe.
- Weergave en labels stel je per store view in. Structured data, categoriekeuze en de selectie van paginatypes stel je per website in.
- Het gewicht van een categorie, het uitsluiten van een categorie en de vaste categorie van een product stel je per store view in.
- De module werkt op Luma en Hyvä, ook als één installatie beide heeft. Het inklappen op mobiel is er op Hyvä.
- Elke instelling in de configuratie zet je met "Use system value" terug naar de standaardwaarde.
Een duidelijk pad op elke pagina
Advanced Breadcrumbs geeft producten, categorieën en CMS-pagina's een kruimelpad dat bezoekers en zoekmachines op dezelfde manier lezen, op Luma en Hyvä.
Magmodules bouwt en onderhoudt de extensie, met support voor elke merchant die ermee werkt.
Kennisbank
Alle bekende helpartikelen
Een lijst met de meest gestelde vragen over de Advanced Breadcrumbs-extensie voor Magento 2. We hebben ons best gedaan om je te helpen met de installatie, configuratie en probleemoplossing. Als je het antwoord dat je zocht niet kunt vinden, kun je ons altijd een bericht sturen via dit formulier.
Installatieartikelen
Installatie met Composer (aanbevolen) Installatie via de Adobe Marketplace Installatie via FTP en SSHConfiguratie
ConfiguratiegidsWijzigingslogboek 1.2.0 is uitgebracht op 9 November 2026
Onze plug-ins worden regelmatig bijgewerkt om compatibiliteit met de nieuwste Magento-versie te garanderen.
-
Features:
- Custom breadcrumb trail per CMS page: an Advanced Breadcrumbs section on the page form holds Hide Breadcrumbs, a Use Custom Breadcrumb Trail switch and a list of crumbs, each with a label and an optional URL. The trail replaces the single title crumb the page would otherwise show, which is the way to place a page under a section such as Service, because CMS pages have no hierarchy of their own. It feeds the JSON-LD as well, with absolute URLs, and the last crumb is the page itself and carries no link. Improvements:
- Breadcrumbs can be asked for a category or a CMS page that is not the current request, and structured data can be rendered for any trail. The GraphQL companion module uses this from 1.1.0 so a headless storefront answers with the trail the shop renders, rather than rebuilding it and drifting.
- The test suite and the static gates of the module standards: PHPUnit with the architecture set, the baseline end-to-end layer that sets every configuration field through the admin form and reads it back, PHPStan at level 8 without a baseline, and the codesniffer at the standard's own severity.
- Two settings scoped to website and store, Enabled and Debug Mode, can be restored to their default again. Bugfixes:
- The admin modals wrote the response of the self-test, the log viewers and the version check into the page without escaping it; the changelog modal now also allows only the tags its own format uses, without attributes.
- The admin log viewer dropped the first character of a short log and cut a long one a line short; it reads the tail through Magento's file driver now.
- A breadcrumb label, title or link of a category without a name no longer reaches the template as null, and a stored configuration value that is not the shape the module expects is refused instead of being used. Compatibility:
- Magento 2.4.x and up
- PHP 8.1 and up
-
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
100% Ongecodeerde codekwaliteit gegarandeerd.
Kwaliteit
Goedgekeurd, compatibel en getest

Adobe Commerce Goedgekeurd door Marketplace
Deze extensie staat op de officiele Adobe Commerce Marketplace en heeft het reviewproces doorlopen op codekwaliteit, performance en beveiliging.
Goedkeuring via de Adobe Marketplace betekent dat de extensie voldoet aan de Magento coding standards en correct integreert met het platform. Updates doorlopen hetzelfde reviewproces.

Magento Cloud Ondersteuning
Deze extensie is volledig compatibel met Adobe Commerce Cloud (Magento Cloud). Het werkt met het read-only filesystem, de build- en deploy-pipeline en cloud-specifieke caching-lagen.
Er is geen extra configuratie of workaround nodig voor cloud-omgevingen. De extensie gaat op dezelfde manier om met static content deployment en configuratiebeheer als bij on-premise installaties.

Privé Composer Repo
Na aankoop krijg je toegang tot een prive Composer-repository met persoonlijke credentials. Installeer en update de extensie met een enkel composer-commando, net als elke andere dependency.
Je Composer-credentials zijn beschikbaar in je accountdashboard. Updates worden gepubliceerd zodra een nieuwe versie beschikbaar is, zodat je altijd toegang hebt tot de laatste versie.
Playwright E2E Tests (68)
This extension is covered by 68 end-to-end tests using Playwright. These tests run automatically on every code change through our CI/CD pipeline.
The tests simulate real user interactions across checkout flows, configuration changes and edge cases to make sure everything works before every release.