Breadcrumbly Documentation

Overview

Add breadcrumbs to posts, pages and products, with BreadcrumbList structured data so Google shows them in search results.

• Breadcrumbs
• BreadcrumbList schema
• Posts, pages and products

Best for: Every WordPress site

Installation

1. Download breadcrumbly-breadcrumbs.zip from My account › My plugins or from your order email. Do not unzip it.
2. In WordPress, go to Plugins › Add New Plugin › Upload Plugin, choose the zip and click Install Now, then Activate.

Requires WordPress 6.0+, PHP 7.4+. Works with any theme, block themes and page builders.

Features

• Home › Category › Article trails
• Posts, pages with parents, products, archives and search
• Added above the content or with [breadcrumbly]
• BreadcrumbList structured data
• Your home label, separator and link color
• Current page shown or hidden
• Accessible markup with aria-current

Shortcodes

Paste a shortcode in any page, post, widget or page builder text block.

• [breadcrumbly]
• [breadcrumbly_preview]

Options of each shortcode are described in the Features above and in the plugin settings page.

For developers

Customize the plugin from your theme’s functions.php or a small plugin, without editing its files (your changes survive updates).

Filters

• breadcrumbly_active
• breadcrumbly_sanitize
• breadcrumbly_trail

add_filter( 'breadcrumbly_active', function ( $value ) {
	// Change $value here.
	return $value;
}, 10, 1 );

Actions

• breadcrumbly_admin_after_form
• breadcrumbly_admin_before_form
• breadcrumbly_admin_form_end

Updates

Updates are free. When a new version is out, it appears in Dashboard › Updates of your WordPress site and you can install it in one click, or turn on automatic updates in Plugins. This works for the zip downloaded from your Woo-Plugins account; older copies can be replaced by downloading the latest version from My plugins. See the changelog.

Frequently asked questions