WPSSO Schema Breadcrumbs Markup

The Most Comprehensive Schema BreadcrumbsList Markup of Any Plugin.

Adds Schema BreadcrumbList markup for posts, pages, custom post types, categories, tags, custom taxonomies, search results, and date archive pages.

Select between using ancestors (aka parents), the primary category, or all categories for posts, pages, and custom post types.

No Templates to Modify:

Simply activate or deactivate the plugin to enable / disable the addition of Schema BreadcrumbList markup.

WPSSO Core Required

WPSSO Schema Breadcrumbs Markup (WPSSO BC) is an add-on for the WPSSO Core plugin, which provides complete structured data for WordPress to present your content at its best on social sites and in search results – no matter how URLs are shared, reshared, messaged, posted, embedded, or crawled.

Install and Uninstall

• Install the Schema Breadcrumbs Markup add-on.
• Uninstall the Schema Breadcrumbs Markup add-on.

Frequently Asked Questions

• How can I add WPSSO breadcrumbs to my theme?

1. 

   WPSSO BC settings page with options to select the type of breadcrumbs for each post type (media, post, page, and custom post types) and taxonomy.

Version Numbering

Version components: {major}.{minor}.{bugfix}[-{stage}.{level}]

• {major} = Major structural code changes and/or incompatible API changes (ie. breaking changes).
• {minor} = New functionality was added or improved in a backwards-compatible manner.
• {bugfix} = Backwards-compatible bug fixes or small improvements.
• {stage}.{level} = Pre-production release: dev < a (alpha) < b (beta) < rc (release candidate).

Standard Edition Repositories

• GitHub
• WordPress.org

Development Version Updates

WPSSO Core Premium edition customers have access to development, alpha, beta, and release candidate version updates:

Under the SSO > Update Manager settings page, select the "Development and Up" (for example) version filter for the WPSSO Core plugin and/or its add-ons. When new development versions are available, they will automatically appear under your WordPress Dashboard > Updates page. You can reselect the "Stable / Production" version filter at any time to reinstall the latest stable version.

WPSSO Core Standard edition users (ie. the plugin hosted on WordPress.org) have access to the latest development version under the Advanced Options section.

Changelog / Release Notes

Version 4.3.1 (2023/01/26)

• New Features
  • None.
• Improvements
  • Updated the minimum WordPress version from v5.2 to v5.4.
• Bugfixes
  • None.
• Developer Notes
  • Updated the WpssoAbstractAddOn library class.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.
  • WPSSO Core v14.7.0.

Version 4.3.0 (2023/01/20)

• New Features
  • None.
• Improvements
  • Added a Yoast SEO compatibility filter to remove its breadcrumbs markup.
• Bugfixes
  • None.
• Developer Notes
  • Updated the SucomAbstractAddOn common library class.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v14.5.0.

Version 4.2.0 (2022/03/10)

• New Features
  • None.
• Improvements
  • Added dynamic placeholders to Document SSO metabox title options.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v11.6.0.

Version 4.1.1 (2022/03/07)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Updated SucomUtilWP method calls to SucomUtil for WPSSO Core v11.5.0.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v11.5.0.

Version 4.1.0 (2022/02/17)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Updated the WpssoPage class get_title(), get_description(), and get_caption() method arguments for WPSSO Core v11.0.0.
  • Renamed the 'schema_bc_title' option key to 'schema_title_bc'.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v11.0.0.

Version 4.0.0 (2022/02/02)

• New Features
  • None.
• Improvements
  • Updated methods and add-on config array keys for WPSSO Core v10.0.0.
• Bugfixes
  • None.
• Developer Notes
  • Renamed 'bc_list_for_ptn_' option keys to 'bc_list_for_'.
  • Updated SucomUtilWP::get_post_types() and SucomUtilWP::get_taxonomies() method arguments.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v10.0.0.

Version 3.10.0 (2022/01/19)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Renamed the lib/abstracts/ folder to lib/abstract/.
  • Renamed the SucomAddOn class to SucomAbstractAddOn.
  • Renamed the WpssoAddOn class to WpssoAbstractAddOn.
  • Renamed the WpssoWpMeta class to WpssoAbstractWpMeta.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v9.14.0.

Version 3.9.0 (2021/12/16)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Replaced a call to WpssoUtil->add_post_type_names() with a new 'wpsso_add_custom_post_type_options' filter hook.
  • Replaced a call to WpssoUtil->add_taxonomy_names() with a new 'wpsso_add_custom_taxonomy_options' filter hook.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v9.12.0.

Version 3.8.1 (2021/11/16)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Removed duplicate 'wpsso_option_type' and 'wpsso_get_defaults' option filter hooks.
  • Refactored the SucomAddOn->get_missing_requirements() method.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v9.8.0.

Version 3.8.0 (2021/11/10)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Updated the default WPSSOBC_SCHEMA_BREADCRUMB_SCRIPTS_MAX value from 20 to 10.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.
  • WPSSO Core v9.7.0.

Version 3.7.0 (2021/10/18)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added more human friendly function names to include breadcrumbs in theme templates:
    • wpsso_breadcrumbs_html()
    • wpsso_get_breadcrumbs_html()
  • Removed cache clearing on activation / deactivation.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.
  • WPSSO Core v9.2.0.

Version 3.6.1 (2021/10/06)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Standardized get_table_rows() calls and filters in 'submenu' and 'sitesubmenu' classes.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.
  • WPSSO Core v9.1.0.

Version 3.6.0 (2021/09/24)

• New Features
  • None.
• Improvements
  • Renamed the Document SSO > Customize > Breadcrumb Title option to Breadcrumb Name and moved it under the Schema Altername Name option.
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoBcFiltersOptions class.
  • Added a new WpssoBcFiltersUpgrade class.
  • Renamed the 'bc_title' metadata options key to 'schema_bc_title'.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.
  • WPSSO Core v9.0.0.

Version 3.5.0 (2021/03/26)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added new 'wpsso_bc_add_home_url' and 'wpsso_bc_add_wp_url' filters.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.
  • WPSSO Core v8.34.0.

Version 3.4.1 (2021/02/25)

• New Features
  • None.
• Improvements
  • Updated the banners and icons of WPSSO Core and its add-ons.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.23.0.

Version 3.4.0 (2020/12/17)

• New Features
  • Added a new "Breadcrumb Title" option in the Document SSO metabox.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added support for WpssoPost->get_primary_terms() from WPSSO Core v8.18.0.
  • Added a new wpsso_bc_show_itemlist_html() function.
  • Added a new wpsso_bc_get_itemlist_html() function.
  • Added a new WpssoBcBreadcrumb::get_mod_itemlist_html() method.
  • Added a new WpssoBcBreadcrumb::get_mod_itemlist_links() method.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.
  • WPSSO Core v8.18.0.

Version 3.3.0 (2020/12/11)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added support for the new $mod array elements in WPSSO Core v8.17.0.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.5.
  • WPSSO Core v8.17.0.

Version 3.2.0 (2020/12/01)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Included the $addon argument for library class constructors.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.5.
  • WPSSO Core v8.16.0.

Version 3.1.1 (2020/10/17)

• New Features
  • None.
• Improvements
  • Refactored the add-on class to extend a new WpssoAddOn abstract class.
• Bugfixes
  • Fixed backwards compatibility with older 'init_objects' and 'init_plugin' action arguments.
• Developer Notes
  • Added a new WpssoAddOn class in lib/abstracts/add-on.php.
  • Added a new SucomAddOn class in lib/abstracts/com/add-on.php.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.13.0.

Version 3.0.1 (2020/09/15)

• New Features
  • None.
• Improvements
  • Updated the French plugin translations.
• Bugfixes
  • None.
• Developer Notes
  • Moved extracted translation strings from lib/gettext-*.php files to a new gettext/ folder.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.
  • WPSSO Core v8.5.0.

Version 3.0.0 (2020/09/05)

• New Features
  • None.
• Improvements
  • Added Schema cleanup for Rank Math to remove its Schema BreadcrumbList markup.
  • Renamed the "Home Page Name" option to "Site Home Page Name" (default value is "Home").
  • Added a new "WordPress Home Page Name" option (default value is "Blog").
  • Added a new "Breadcrumbs by Taxonomy" option.
• Bugfixes
  • None.
• Developer Notes
  • Added a new lib/filters-messages.php library file.
  • Added support for terms, users, search results, and date archive pages in WpssoBcFilters->filter_json_data_https_schema_org_breadcrumblist().
  • Updated the WpssoBcBreadcrumb::add_itemlist_data() method to add the WordPress Address URL (ie. the "WordPress Home Page") to the breadcrumbs list when different to the Site Address URL (ie. the "Site Home Page").
  • Added a lib/compat.php library file for third-party plugin and theme compatibility actions and filters.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.
  • WPSSO Core v8.4.1.