To implement breadcrumbs in Webflow that reflect the correct folder hierarchy (not just the immediate parent page), you'll need to manually structure breadcrumbs using CMS data, page settings, or custom attributes.
1. Understand Webflow Limitations with URL Structure
- Webflow uses folders to organize static and CMS collection pages, but it does not automatically generate or expose the folder hierarchy for dynamic use (like in breadcrumbs).
- Webflow’s built-in CMS does not natively support parent-child CMS item relationships unless modeled manually.
2. Use CMS Collections with Hierarchy (for Blog or Category Pages)
If you’re using CMS collections (e.g., blog posts grouped into categories):
- Add a reference field in your CMS (e.g., Blog Post → Category, or Category → Parent Category).
- For breadcrumbs, manually output the data using multi-reference or reference fields:
- Blog Post → Category → Parent Category.
- Set a dynamic breadcrumb text and link using those relationships.
3. For Static Pages in Folders (Manual Setup)
If you’re using static pages in folders (e.g., /guides/seo-tools/page-name
):
- Breadcrumbs must be manually mapped because Webflow does not expose URL path components dynamically.
- Use custom page variables created via [Page Settings → Custom Attributes] (e.g.,
data-breadcrumb-level1="Guides"
). - On each page, insert a
Breadcrumb
component (or custom structure) and use Webflow’s conditional visibility: - Show/pre-fill breadcrumbs manually or set via attributes like
data-breadcrumb-title
.
4. Optional: Use Custom JavaScript (If You Need Auto-Generation)
If manual setup isn’t scalable, use JavaScript to auto-generate breadcrumbs using the URL path:
- Use
window.location.pathname.split('/')
to get folder structure. - Match those with labels (folder-to-title mapping) and update the breadcrumb component dynamically.
- Keep in mind: Webflow won’t provide folder metadata, so you must hardcode a lookup table.
5. Design the Breadcrumb Component
- Create a simple Section → Div Block → Text Links structure.
- Use arrows, slashes, or chevron icons to separate breadcrumb steps.
- Set the current page’s breadcrumb item to non-link text for best UX.
Summary
Webflow doesn’t automatically map folder-based breadcrumbs, so you must manually set breadcrumb hierarchy using CMS reference fields or page-level attributes. For static sites, use custom attributes or JavaScript to reflect the folder path as a breadcrumb trail.