OdooWiki OCA HUB

Website Breadcrumbs

website_breadcrumb folder_open OCA/website open_in_new
Website License: LGPL-3

This module allows you to have breadcrumbs in any page of your website. But if an URL is not present in a menu (as indicated in the Configuration section), no breadcrumbs will display.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds breadcrumb navigation to your website pages, showing the path from the home page through the menu hierarchy to the current page. Breadcrumbs only appear when the page's URL matches an existing website menu item.

This module adds a breadcrumb trail to pages of your Odoo website. A breadcrumb is the small line of links (for example Home / Shop / Category) that shows visitors where they are and lets them jump back to a parent page.

Where it appears: - The breadcrumb is inserted in the website header area, above the page content, and is shown as a light rounded bar. - It is a website customization, so you can turn it on or off per website from the website editor's customization options.

How it works: - When a page is displayed, Odoo looks for a website menu item whose URL matches the page address. - If a matching menu item is found, the breadcrumb is built from that menu item and all of its parent menu items, ordered from the top-level menu down to the current page. - The first step links to the home page; intermediate steps link to their menu URLs; the last item is the current page and is shown as plain text, not a link. - If the page's URL is not present in any website menu, no breadcrumb is displayed at all.

It extends the website.menu model with a helper that lists a menu's parents, and it touches the website layout and breadcrumb templates. No new menus, reports, emails or scheduled actions are added.

Depends on

website
Models and fields (1)
  • website.menu · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 5 confirmed, 4 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 18.0

To configure the shown breadcrumbs, you need to:

  • Enable developer mode.
  • Go to Website Admin \> Configuration \> Menus.
  • Remove the website grouping from the filter if it is set.
  • Edit any menu there.

Keep in mind that:

  • This module will try to match exactly the URL in the menu item with the one you are browsing.
  • If it finds no match, breadcrumbs will not be shown.
  • If it finds several matches, only the first one will be used.
  • Using more than 1 submenu for the website top menu will probably make it unusable. In case you need that granularity, you will have to create a separate top menu for managing your breadcrumbs.
  • Breadcrumbs use the menu name, not the page name, except for the top menu item, which will appear as Home and point to / unless you specify an URL for it.

To use this module, you need to:

  • Log in.
  • Go to your home page and click on the body of the page.
  • Open the web editor and go to the Customise tab.
  • Enable Breadcrumbs (it is enabled by default).
  • If you want to use this module in a theme but you do not like where it is rendered, you can simply disable it in the top menu and add in you own layout a <t t-call="website_breadcrumb.breadcrumb"/> element.

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.