Smart Breadcrumbs for Elementor

By Themepoints

200+ active installationsVersion 1.1.0

A lightweight, accessible breadcrumb widget for Elementor with correct BreadcrumbList schema that never duplicates your SEO plugin.

Description

Smart Breadcrumbs for Elementor adds an SEO-friendly, accessible breadcrumb trail to your Elementor pages and templates.

Features:
* Home link toggle and custom Home label
* Style presets: Plain, Pills, Arrow Chips and Boxed
* Home icon (any Elementor icon or SVG), with an icon-only option
* Text or icon separators
* Responsive alignment (desktop, tablet and mobile)
* Show/hide the current page, or hide the whole trail on the front page
* Max depth: long trails collapse in the middle (Home … Parent › Current)
* Title length limit with full title on hover
* Custom labels for the blog page, search results, 404 and paginated pages
* Mobile modes: show only the parent as a back link, or scroll the trail horizontally
* Semantic markup: nav, ordered list and aria-current for screen readers
* BreadcrumbList schema, printed once per page, always built from the full trail
* Schema is skipped automatically when Yoast SEO, Rank Math, AIOSEO, SEOPress or The SEO Framework is active (can be overridden)
* Works with posts, pages, hierarchical custom post types, categories, tags, custom taxonomies, author, date, search, 404, blog page and paginated archives
* Uses the primary category set in Yoast SEO or Rank Math
* WooCommerce: Shop > Category > Subcategory > Product, plus shop and product category archives
* Sample trail shown in the Elementor editor when designing templates
* Developer filters: sbfe_trail_items, sbfe_singular_taxonomy, sbfe_singular_term, sbfe_schema, sbfe_external_schema_active
* Full Elementor style controls: container, items (normal and hover), home item, separator and current item, with background, border, radius, padding, spacing and shadow

Installation

  1. Upload ‘smart-breadcrumbs-for-elementor’ to ‘/wp-content/plugins/’.
  2. Activate the plugin from the WordPress plugins menu.
  3. Open Elementor and search for “Smart Breadcrumbs”.
  4. Drag & drop into your layout.

FAQ

Does this work with Elementor Free?

Yes, fully compatible (Elementor 3.5 or newer).

Does it support WooCommerce?

Yes. Product pages show the Shop page and the product’s category trail, and shop and category archives are supported.

Will the schema conflict with my SEO plugin?

No. If Yoast SEO, Rank Math, AIOSEO, SEOPress or The SEO Framework is active, this plugin does not print its own BreadcrumbList. You can force it on in the widget’s SEO / Schema section.

Can I show only the parent page on phones?

Yes. In the widget’s Mobile section, enable “Show Only Parent on Mobile”. Phones then show a single “← Parent” link. The mobile breakpoint is 767px, Elementor’s default.

Why does the editor show a sample trail?

When you edit a template (header, single, archive), the template itself has no real breadcrumb, so a sample trail is shown. The live page shows the real trail.

Changelog

1.1.0

  • New: style presets (Plain, Pills, Arrow Chips, Boxed).
  • New: home icon, icon-only home, and icon separators using the Elementor icon library.
  • New: responsive alignment.
  • New: container, item, home, separator and current-item style controls (hover states, background, border, radius, padding, spacing, shadow, separate typography for the current item).
  • New: custom labels for blog, search, 404 and paginated pages.
  • New: title length limit, hide on front page.
  • New: mobile “parent only” back link and horizontal scroll mode.
  • New: trail is built once as data; the HTML and schema both come from it.
  • Fix: schema printed once per page, no duplicates with multiple widgets.
  • Fix: schema no longer loses items when Max Depth or Show Current is used.
  • New: schema skipped automatically when an SEO plugin already outputs BreadcrumbList.
  • Fix: category parents are resolved by term ID, not by name.
  • New: primary category support (Yoast SEO, Rank Math).
  • New: WooCommerce product category trail and Shop page crumb.
  • New: hierarchical custom post type ancestors, attachments, blog page, date archives, pagination.
  • New: sample trail in the Elementor editor for templates.
  • Improved: Max Depth now collapses the middle of the trail instead of removing Home.
  • Improved: semantic nav/ol/li markup with aria-current; RTL-aware alignment.
  • Improved: removed the empty JavaScript file and the jQuery dependency.
  • New: Elementor minimum version check.

1.0.0

Initial release.