WooCommerce Docs

Documentation, Reference Materials, and Tutorials for your WooCommerce products



Introduction ↑ Back to Top

Help your users navigate your website and keep track of their path using woocommerce_breadcrumb().

Note: We are unable to provide support for customizations under our Support Policy. If you are unfamiliar with code/templates and resolving potential conflicts, contact a WooExpert.

What is woocommerce_breadcrumb()? ↑ Back to Top

The woocommerce_breadcrumb() outputs the WooCommerce Breadcrumb.

Parameters ↑ Back to Top

Please note that all parameters are optional.

The $args array

  • delimiter – The character to display between the breadcrumbs.
  • wrap_before – The breadcrumb’s container starting code
  • wrap_after – The breadcrumb’s container ending code
  • before – HTML to display before the breadcrumbs.
  • after – HTML to display after the breadcrumbs.
  • home – Include the front page at the beginning of the breadcrumbs.

Filtering default arguments ↑ Back to Top

You can easily change default arguments using the woocommerce_breadcrumb_defaults filter. Use the WordPress builtin add_filter() function.

Examples ↑ Back to Top

Basic Usage

<?php woocommerce_breadcrumb(); ?>

Usage with custom arguments

In the example below, we’re using custom arguments to change the breadcrumb separator as well as the HTML to display before the breadcrumbs.

	$args = array(
			'delimiter' => '/',
			'before' => '<span class="breadcrumb-title">' . __( 'This is where you are:', 'woothemes' ) . '</span>'
<?php woocommerce_breadcrumb( $args ); ?>
Back to the top