WooCommerce · Info
WooCommerce Breadcrumbs Settings Explained: What Each Option Does

Short answer
WooCommerce has no breadcrumbs settings page. You control breadcrumbs through your theme options, the Breadcrumbs block in block theme templates, an SEO plugin, or the woocommerce_breadcrumb_defaults filter, which changes the separator, wrapper HTML and Home text.
Key takeaways
- WooCommerce has no breadcrumbs settings screen.
- Theme options are the easiest place to start.
- The defaults filter changes separator, wrappers and Home text.
- Block themes use a Breadcrumbs block in templates.
- SEO plugins add breadcrumbs with structured data.
- Avoid showing two breadcrumb trails at once.
Where are the WooCommerce breadcrumbs settings?
WooCommerce has no breadcrumbs settings screen, so you change breadcrumbs through your theme's Customizer options, the Breadcrumbs block in block themes, an SEO plugin, or a small code filter called woocommerce_breadcrumb_defaults.
Breadcrumbs are the small trail of links, like Home / Shop / Shoes / Running Shoe, that shows where a page sits in your store.
WooCommerce prints them on shop, category and product pages by default in many themes. But it leaves the look and placement to your theme and to developers.
That is why people search the WooCommerce settings tabs and find nothing. This article explains each place breadcrumb options can live and what each option does.
What controls WooCommerce breadcrumbs?
Four things can control WooCommerce breadcrumbs: your theme, the block editor templates, an SEO plugin, and code filters, and the one that wins depends on your setup.
| Method | Where you change it | Good for |
|---|---|---|
| Theme options | Appearance, then Customize, or the theme panel | Turning breadcrumbs on or off, basic styling |
| Block theme templates | Appearance, then Editor, product and archive templates | Moving or removing the Breadcrumbs block |
| SEO plugin | Yoast SEO, Rank Math and similar settings | Site-wide breadcrumbs with schema |
| Code filters | Child theme or snippets plugin | Changing separator, home text, wrapper HTML |
Start with the theme. Many popular themes have a simple breadcrumb toggle that saves you from writing code.
If you are not sure which method is active, view the page source and look at the HTML around the trail. A class like woocommerce-breadcrumb points to WooCommerce, while SEO plugins and themes usually use their own class names.
What options does the woocommerce_breadcrumb_defaults filter change?
The woocommerce_breadcrumb_defaults filter changes the separator, the wrapper HTML before and after the trail, the HTML around each item, and the text of the Home link.
WooCommerce documents it in its guide to customizing the WooCommerce breadcrumb. The options are:
- delimiter: the character between links, a slash by default.
- wrap_before: HTML that opens the trail, usually a
navelement. - wrap_after: HTML that closes the trail.
- before: HTML placed before each crumb.
- after: HTML placed after each crumb.
- home: the text for the first link, Home by default.
Here is an example that changes the separator and Home text:
add_filter( 'woocommerce_breadcrumb_defaults', function ( $defaults ) {
$defaults['delimiter'] = ' › ';
$defaults['home'] = 'Store';
return $defaults;
} );
Add code like this to a child theme or a snippets plugin. The add_filter reference explains how filters work.
How do you change where the Home link points?
Use the woocommerce_breadcrumb_home_url filter to send the first breadcrumb link to your shop page or any other URL instead of the site's front page.
This is useful when your store sits inside a bigger site and you want Home in the trail to mean the shop.
add_filter( 'woocommerce_breadcrumb_home_url', function () {
return wc_get_page_permalink( 'shop' );
} );
Pair it with the home text option above, so the label matches the link. A link called Home that opens the shop can confuse shoppers.
How do you remove WooCommerce breadcrumbs?
Turn them off in your theme options if possible, remove the Breadcrumbs block in block themes, or remove the woocommerce_breadcrumb action in a classic theme with one line of code.
In classic themes, WooCommerce hooks breadcrumbs onto the content area. The standard removal code is:
add_action( 'init', function () {
remove_action( 'woocommerce_before_main_content', 'woocommerce_breadcrumb', 20 );
} );
Some themes move breadcrumbs to their own hooks, such as a header area. In that case the line above will not work, and you need the theme's own hook name or setting.
Our guide on how to remove breadcrumbs in WordPress covers more themes and plugins.
How do breadcrumbs work in block themes?
In block themes, breadcrumbs are a block placed in the product and shop templates, so you move, style or delete them in the Site Editor instead of with PHP hooks.
Go to Appearance, then Editor, then Templates. Open Single Product or Product Catalog and look for the breadcrumbs block near the top.
From there you can:
- Delete the block to hide breadcrumbs.
- Drag it to another spot in the template.
- Change its font size and colour in the block settings.
Changes apply to every page that uses that template. If a category looks different, check whether it uses its own template.
Keep a backup of any template you change. The Site Editor lets you reset a template to its default if a change goes wrong, but that also wipes your other edits to it.
Code filters for the trail's content still apply in many cases, because the block reads the same breadcrumb data.
Should you use SEO plugin breadcrumbs instead?
Use SEO plugin breadcrumbs if you want one consistent trail across posts, pages and products with built-in structured data, and turn off the WooCommerce trail so you do not show two.
Yoast SEO and Rank Math both offer breadcrumbs that work on products and categories. They let you choose the separator, home text and which taxonomy to show.
After switching, check product pages for duplicate trails. Remove the theme or WooCommerce breadcrumbs if both appear.
For setup steps, see our guide to Yoast SEO breadcrumbs settings.
Some themes also have their own options, as in our guide to OceanWP breadcrumbs settings.
Do breadcrumbs help SEO?
Breadcrumbs help search engines understand your store's structure and can appear in search results when the page includes breadcrumb structured data.
Google explains the markup in its breadcrumb structured data guide. The format follows the BreadcrumbList type on schema.org.
WooCommerce adds some structured data to product pages, and SEO plugins add their own. Avoid adding several versions of the same markup.
Breadcrumbs also help shoppers. A clear trail makes it easy to step back to a category and keep browsing.
Which category shows in the trail?
When a product belongs to several categories, WooCommerce picks one to show in the trail, and you can influence the choice with filters or a primary category in an SEO plugin.
This is a common complaint. A product in both Sale and Shoes may show Sale when you want Shoes.
SEO plugins that support a primary category let you choose it on each product. Their breadcrumbs then use that category.
Developers can also adjust the trail with the woocommerce_get_breadcrumb filter, which receives the full array of crumbs before output.
How do you style WooCommerce breadcrumbs?
Style breadcrumbs with CSS targeting the woocommerce-breadcrumb class, or use your theme's typography and colour settings if it offers them.
A simple example:
.woocommerce-breadcrumb {
font-size: 14px;
color: #666;
}
.woocommerce-breadcrumb a {
color: #222;
}
Add CSS in Appearance, then Customize, then Additional CSS, or in your child theme. If your theme wraps the trail in its own markup, inspect the page to find the right class.
If you build store pages with a page builder, see our guide on how to use WooCommerce with Elementor, which has its own breadcrumbs widget.
Frequently asked questions
Why can't I find breadcrumbs in WooCommerce settings?
WooCommerce does not include a breadcrumbs options screen. The trail is printed by the plugin, but its look and placement are left to your theme, block templates, SEO plugins or small code filters.
How do I change the breadcrumb separator in WooCommerce?
Use the woocommerce_breadcrumb_defaults filter and set the delimiter value to the character you want, such as a right angle quote. Add the code to a child theme or snippets plugin, then clear your cache.
How do I hide breadcrumbs on product pages only?
In a block theme, remove the Breadcrumbs block from the Single Product template. In a classic theme, remove the breadcrumb action with a condition that checks for product pages, or use your theme's per-page options if it has them.
Do WooCommerce breadcrumbs include schema markup?
WooCommerce adds some structured data, and many SEO plugins output breadcrumb markup with their own trail. Check one product page with Google's Rich Results Test to see what is present and avoid duplicates.
Why does my product show the wrong category in breadcrumbs?
When a product has several categories, one is picked automatically for the trail. Set a primary category in an SEO plugin that supports it, or adjust the crumbs with the woocommerce_get_breadcrumb filter.
Sources
- Customize the WooCommerce breadcrumb WooCommerce
- add_filter() WordPress Developer Resources
- Breadcrumb structured data Google Search Central
- BreadcrumbList Schema.org
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


