=== BreadcrumbsPress === Contributors: GDragoN, freemius Donate link: https://www.dev4press.com/plugins/breadcrumbspress/ Tags: breadcrumbs, navigation, breadcrumb, crumb, elementor Stable tag: 5.0 Requires at least: 6.7 Tested up to: 7.2 Requires PHP: 8.1 License: GPLv3 or later License URI: http://www.gnu.org/licenses/gpl-3.0.html Add customizable breadcrumb navigation to WordPress posts, pages, archives, and supported plugins. == Description == BreadcrumbsPress creates breadcrumb trails that help visitors navigate your website, such as Home → Category → Post. Add a trail with a block, shortcode, Elementor widget, theme integration, WordPress action, or PHP code. BreadcrumbsPress can output breadcrumb structured data in JSON-LD format. This helps search engines understand a trail; it does not guarantee how a page appears in search results. = Getting Started = Activating the plugin does not necessarily place a visible trail on your site. Choose a placement method: * Add the Breadcrumbs block to a page or template in the block editor. * Add `[breadcrumbspress_current]` to a Shortcode block or another shortcode-enabled area. * Add the Breadcrumbs widget to an Elementor page or template. * For a supported theme, open Settings → BreadcrumbsPress → Settings → Integration, choose a theme integration method and location, and save. * Configure a WordPress action in Integration settings, or use the PHP example on the plugin's Overview page in an appropriate theme template. Check the trail on the front end. Use one placement method per location and check for breadcrumbs already added by your theme or another plugin to avoid duplicates. For setup guides and more information, visit the [BreadcrumbsPress Knowledge Base](https://www.dev4press.com/kb/product/breadcrumbspress/). = Block Editor Support = The Breadcrumbs block displays a single trail for the current context. Add it to content or a template in the block editor. = Support for Elementor = Add the Breadcrumbs atomic widget to an Elementor page or template and adjust its styling in Elementor. The widget requires Elementor 4 or later with atomic widget functionality active. = Breadcrumbs Generated by the Plugin = BreadcrumbsPress supports a range of content and page types, including: * WordPress: front and posts pages, posts, pages, custom post types, categories, tags, custom taxonomies, date and author archives, search results, and 404 pages. * WooCommerce: shop, products, categories, tags, and account pages. * BuddyPress: activity, groups and members directories, groups, and user profiles. * bbPress: forums, topics, replies, topic views and tags, user profiles, and GD Members Directory. Control trail visibility, paths for posts and terms, separators, styling, and markup in the plugin settings. The plugin also includes icons for separators and selected crumbs. = Integration into WordPress = BreadcrumbsPress can integrate with WordPress actions and supports automatic or manual integration with these themes and frameworks: * GeneratePress * Kadence * OceanWP * Astra * Storefront * Blocksy * Genesis Framework Available locations depend on the theme and its hooks. You can also place breadcrumbs using a block, widget, shortcode, or PHP code. = Plugin Pro Edition = The free edition generates a single breadcrumb trail. BreadcrumbsPress Pro adds: * Multi breadcrumbs: display multiple available paths to a post using a block, shortcode, or Elementor atomic widget. * Menu breadcrumbs: display the items of a selected WordPress navigation menu in menu order using a shortcode. * Length controls: collapse intermediate crumbs in long trails and shorten long intermediate crumb text. * [Compare Free vs Pro Editions](https://www.dev4press.com/plugins/breadcrumbspress/articles/lite-vs-pro/) * [Upgrade to Pro Edition](https://www.dev4press.com/plugins/breadcrumbspress/pricing/) == Installation == BreadcrumbsPress requires WordPress 6.7 or newer and PHP 8.1 or newer. = From the WordPress Plugin Directory = 1. Open Plugins → Add New Plugin in your WordPress administration area. 2. Search for BreadcrumbsPress, install it, and activate it. 3. Follow any setup prompts and open Settings → BreadcrumbsPress. = From a ZIP File = 1. Download the plugin ZIP file and open Plugins → Add New Plugin → Upload Plugin. 2. Select the ZIP file, install it, and activate the plugin. 3. Follow any setup prompts and open Settings → BreadcrumbsPress. For manual installation, extract the ZIP and upload the `breadcrumbspress` folder to `/wp-content/plugins/`, then activate the plugin. == Frequently Asked Questions == = Where can I configure the plugin? = Open Settings → BreadcrumbsPress in the WordPress administration area. = How do I display breadcrumbs? = Add the Breadcrumbs block, the `[breadcrumbspress_current]` shortcode, or the Elementor Breadcrumbs widget. You can also configure a theme or action integration, or add PHP code to a theme template. See Getting Started above. = Why don't breadcrumbs appear? = Check that a placement method is configured and that visibility is enabled for the page type in BreadcrumbsPress settings. For a theme integration, check the selected theme and location. Preview the front end and clear any relevant caches after changes. = How do I prevent duplicate breadcrumbs? = Check for multiple placement methods, or breadcrumbs supplied by your theme or another plugin. Remove the extra placement. The Advanced settings can also disable WooCommerce or bbPress breadcrumbs when those integrations are active. = Does the plugin add structured data? = BreadcrumbsPress can include breadcrumb JSON-LD structured data. You can control it in the Markup settings. Search engines decide how to use this data, so its inclusion does not guarantee a particular search result appearance. == Changelog == = Version: 5.0 / november 11 2026 = * New: `PHP`: a minimum required version is 8.1 * New: replaced complete building tooling * New: support for `Elementor` 4 * New: elementor: single breadcrumbs atomic widget * Edit: massively improved escaping and sanitization * Edit: replaced the POT file build system * Edit: Dev4Press Library 5.6.5 * Removed: various unused files * Fix: few settings issues with invalid controls rendering * Fix: some of the options not properly parsed and used * Fix: several potential issues with missing escaping * Fix: several potential issues with missing sanitization * Fix: problem with the HTML wrapper when using UL * Fix: potential problem with the JSON-LD breadcrumbs * Fix: few potential issues with the showing hidden or private posts * Fix: various minor styling issues = Version: 4.8 / october 24 2026 = * Edit: Updated system requirements * Edit: updated blocks packages dependencies to WP 6.7 * Edit: Freemius SDK 2.13.5 = Version: 4.7 / july 17 2026 = * New: tested and compatible with `WordPress` 7.0 * Edit: updated blocks to API version 3 * Edit: updated blocks packages dependencies to WP 6.4 * Edit: updated some dependencies * Edit: Dev4Press Library 5.5.2 * Edit: Freemius SDK 2.13.4 = Version: 4.6 / november 12 2025 = * New: tested and compatible with `PHP` 8.5 * New: tested and compatible with `WordPress` 6.8 * Edit: Dev4Press Library 5.3 * Edit: Freemius SDK 2.13 Full changelog: [BreadcrumbsPress Changelog](https://www.dev4press.com/plugins/breadcrumbspress/changelog/) == Upgrade Notice == = 5.0 = * Support for Elementor. Many improvements and fixes. Updated shared library. = 4.8 = * Various updates and improvements. = 4.7 = * Various updates and improvements. == Screenshots == 1. Basic breadcrumbs examples 2. Additional breadcrumbs examples 3. Integrated in GeneratePress theme 4. Block 5. Main administration page 6. Theme integration settings 7. Breadcrumbs styling settings 8. Various other settings 9. Few more examples