Flexy Breadcrumb

Plugin Banner

Flexy Breadcrumb

by PressTigers

Download
Description

Flexy Breadcrumb by PressTigers is a clean, robust, and accessible breadcrumb navigation system for WordPress sites. By using this plugin, you can display breadcrumb navigation anywhere in your website via the [flexy_breadcrumb] shortcode or the flexy_breadcrumb() PHP template tag.

With the help of this plugin, you can customize the text, links, separators, typography, and styling of your breadcrumbs to match your site design seamlessly.

Plugin Features

  • SEO Friendly: Includes valid Schema.org structured data (Microdata and JSON-LD) for rich snippets in Google Search.
  • Easy Implementation: Use anywhere on your site via [flexy_breadcrumb] shortcode or native PHP template tag.
  • Customizable Separator: Easily change the breadcrumb separator character or icon.
  • Custom Home & End Text: Set custom Home text, Home URL, and current page/post end text.
  • Word & Character Limits: Set word or character limits for breadcrumb titles to keep navigation clean.
  • Font Awesome Icon Picker: Choose any Font Awesome icon for the Home item with an integrated icon picker.
  • Global Color Options: Complete color controls for text, links, separators, and background through global settings.
  • Typography Controls: Adjust the font size of the breadcrumb trail with automatic theme font matching.
  • Accessible (A11y): Built with semantic <nav aria-label="Breadcrumbs">, aria-current="page", and screen-reader optimizations.
  • Modern Responsive Layout: Clean Flexbox layout with full right-to-left (RTL) language support out of the box.
  • E-Commerce & CPT Ready: Supports WooCommerce categories and tags, custom post types, hierarchical taxonomies, archives, author pages, search, and 404 pages.
  • GDPR Compliant: No remote external font loading in WordPress Admin.
  • Developer Extensible: Global flexy_breadcrumb() template tag and filter hooks (flexy_breadcrumb_output, flexy_breadcrumb_enqueue_font_awesome).

Shortcode

Add this anywhere in your posts, pages, or theme templates:

[flexy_breadcrumb]

PHP Template Tag

Add this directly inside your theme template files (e.g. header.php or archive.php):

<?php if ( function_exists( 'flexy_breadcrumb' ) ) { flexy_breadcrumb(); } ?>

Submit Patches

If you’ve identified a bug or have an improvement, we welcome contributions at our GitHub page for Flexy Breadcrumb. Simply submit a pull request so we can review and merge into the codebase. Happy coding!

Credits

  1. jQuery UI (https://jqueryui.com)
  2. WP Color Picker Alpha (https://github.com/23r9i0/wp-color-picker-alpha)
  3. Font Awesome Icon Picker (https://github.com/itsjavi/fontawesome-iconpicker)
  1. Upload the flexy-breadcrumb folder to your /wp-content/plugins/ directory or install directly via WordPress Plugins screen.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Configure your breadcrumb preferences under Flexy Breadcrumb in the WordPress admin menu.
  4. Add the [flexy_breadcrumb] shortcode in the block editor/page content or use <?php flexy_breadcrumb(); ?> in your theme.
  1. <strong>Basic Theme</strong> - Front-end view of breadcrumb trail.

    Basic Theme – Front-end view of breadcrumb trail.

  2. <strong>General Settings</strong> - Manage general breadcrumb settings and post hierarchy.

    General Settings – Manage general breadcrumb settings and post hierarchy.

  3. <strong>Typography Settings</strong> - Configure color options and font size for breadcrumbs.

    Typography Settings – Configure color options and font size for breadcrumbs.

How do I add Flexy Breadcrumbs to my theme?

You can call the native template tag directly:

Or use WordPress do_shortcode:

How can I prevent duplicate Font Awesome stylesheets if my theme already includes it?

Add the following snippet to your theme’s functions.php:
add_filter( ‘flexy_breadcrumb_enqueue_font_awesome’, ‘__return_false’ );

Does this plugin output Google Search Console compliant structured data?

Yes! Flexy Breadcrumb 1.3.0 outputs valid Schema.org BreadcrumbList via JSON-LD in addition to microdata markup, resolving Google Search Console errors.

Nice but some deprecation error non php 8+

By misthero on June 7, 2024

Deprecated: Creation of dynamic property Flexy_Breadcrumb_Trail::$before_wrap is deprecated in /wp-content/plugins/flexy-breadcrumb/includes/class-flexy-breadcrumb-shortcode.php on line 66

Need custom layout

By egromspam0002 on July 2, 2022

Need custom layout

Very useful

By bajrami09 on June 3, 2022

Very useful

can be better

By Sepi (sepicompanywork) on May 11, 2022

can be so much better -dont have any Guide about how to use (exepet plugin home in wordpress.org) -can have so much more option abot css,like padding or text align -dont have any direction for rtl tnx from developer

Nice looking, but

By pressattache11 on April 9, 2021

I personally only use the shorter code entered into any of the “text “widgets Go into Customizing/widgets/(now choose area you want it to be placed at)add a widget/text Enter [flexy_breadcrumb] into the text field UPDATE: looked like the best breadcrumb plugin, but today I noticed that it doesn’t work with my secondary menu properly. It shows Home and after that immediately the page I am on, skipping all the hierarchy like if it doesn’t exist. I use Simple Grid pro theme btw. That’s a pity, because I really liked it otherwise.

Love it! So clean and Easy to use!

By Website Dude (modernscarface) on August 26, 2020

The settings page gives you just enough to style it and make them look good. Great job!

Thank you! Exactly what I needed! Just a small suggestion, though.

By rcnyc on May 21, 2020

I’ve been looking everywhere for the perfect breadcrumbs plugin for ages. Either they were all wrong or screwed up my installation when they updated. This one is perfect, and I couldn’t be happier with it. All I suggest is that in your display instructions, you post the full code to add to your .php files. You say that all you have to do is add the [flexy_breadcrumb] short code. That’s true if you add it within the editor, but it took me awhile to figure out that to add it to the file itself, you have to add it in this way:
<?php echo do_shortcode( ‘[flexy_breadcrumb]’ ); ?>
This little bit of detail won’t be self-evident to some people, so I think you should let them know that this is how you add it. Otherwise, job well done!

The Best out there !

By iksa01 on May 17, 2020

After Using yoast for years (2013-2020) finally made the move and I am very happy with the results ! After wasting hours on Parent category> Child category> issue of yoast which is breaking the hierarchy , tried Navxt on recommendation of WP-beginner, it was breaking so many things. Then enter Flexy Breadcrumb, works like a charm ,super clean, allows customization and solved the issues in every way. Hope more people will see it as a better alternative and use it, and updated regularly too ! Good luck and thank you for a wonderful plugin.

Great, simple, efficient plugin

By misterdaco on December 23, 2019

Great plugin, excellent and fast support, you guys rock !

Good plugin

By oswaldonunez on September 13, 2019

Wonderful. So far it seems like a tremendous plugin, simple and practical. I hope I don’t do something negative later. But definitely, so far it is going very well.

1.3.1

  • Security – Fixed critical Reflected Cross-Site Scripting (XSS) vulnerability in the search page breadcrumb generation.
  • Security – Enhanced input sanitization and output escaping across all breadcrumb generation functions to prevent XSS and other injection attacks.

1.3.0

  • Feature – Added support for direct theme integration to display breadcrumbs anywhere in your theme templates.
  • Feature – Added Schema.org JSON-LD structured data for better SEO and Google Search Console indexing.
  • Feature – Added full accessibility (a11y) and screen reader support following modern web standards.
  • Feature – Modernized layout styling with automatic theme font matching and full right-to-left (RTL) language support.
  • Feature – Added customization hooks for developers to easily filter breadcrumbs and icon loading.
  • Security – Enhanced security and data validation across all plugin settings.
  • Performance – Faster page loading by removing frontend jQuery dependency.
  • Performance – Optimized admin dashboard loading by only loading plugin assets on the settings page.
  • Performance – Removed external Google Fonts in the admin dashboard for full GDPR/privacy compliance.
  • Fix – Fixed admin settings page errors on newer WordPress versions.
  • Fix – Resolved PHP 8.2+ compatibility issues and warning notices across post, archive, and category breadcrumbs.
  • Fix – Fixed title trimming issues for international languages and special characters.
  • Fix – Ensured existing settings are safely preserved during plugin activation and updates.

1.2.1

  • Fix – Fixed the issue where field “item” missing (in “itemListElement”).

1.2.0

  • Feature – Made it compatible with the WooCommerce product categories and tags.
  • Feature – Made it compatible with the Simple Job Board job categories.
  • Feature – Added “Home Text URL” field in General settings for Flexy Breadcrumb.
  • Fix – Fixed the issue where “Home”, “Page” and other strings were not translatable.
  • Fix – Fixed the issue where HTML tags in posts title appear in breadcrumb.
  • Fix – Fixed the issue where date and tags “Post Types Hierarchy” doesn’t work for custom post types.
  • Fix – Fixed the issue where the blog page is binded to incorrect URL on change of domain.

1.1.4

  • Feature – Added breadcrumb trail for Blog.
  • Tweak – Updated Google Structured of breadcrumbs.
  • Fix – Fixed the responsive spacing issue of separator.
  • Fix – Resolved separator color issue related to typography.

1.1.3

  • Tweak – Added compatibility for WordPress 5.5.

1.1.2

  • Fix – Resolved errors of breadcrumb trail with Google Search Console.

1.1.1

  • Fix – Added slash at the end of the URL – Google Recommendation.
  • Fix – Wrapping the admin style to avoid from any style conflict.
  • Tweak – Update the schema links to https.

1.1.0

  • Feature – Added breadcrumb trail for default posts page.
  • Feature – Display category in post detail page having highest count.
  • Fix – Fixed Google Structured Schema for Breadcrumbs.
  • Fix – Remove archive link for custom post type if archive parameter is false.
  • Tweak – Display only highest category count in post detail page.

1.0.3

  • WP 4.9 Compatibility – Resolved the color picker issue in settings’ typography tab.
  • Fix – Resolved the space issue between the attributes.

1.0.2

  • Fix – Resolved the structured data issue for active list element.

1.0.1

  • Fix – Resolved the floating issues in breadcrumb template.
  • Fix – Fixed the styling glitches of settings tab’s layout.
  • Fix – Resolved the 404 error in case of home page.

1.0.0

  • Initial release.