Voxel Toolkit 1.6.1 is Available!

Breadcrumbs Widget

The Breadcrumbs widget displays hierarchical navigation breadcrumbs showing the path from the homepage to the current page. Help visitors understand where they are and navigate back to parent pages easily.


Overview

Show users their current location within your site’s hierarchy. The widget automatically generates breadcrumb trails based on page structure, post types, and taxonomy terms. Includes SEO-friendly schema markup for better search engine visibility.

Key Features

  • Automatic breadcrumb trail generation
  • Works with pages, posts, archives, and custom post types
  • Voxel taxonomy field support
  • JSON-LD schema markup for SEO
  • Multiple separator styles
  • Full styling customization
  • Responsive design

Setup Instructions

Step 1: Enable the Widget

  1. Navigate to Voxel Toolkit > Widgets in your WordPress admin
  2. Find Breadcrumbs in the list
  3. Toggle the switch to enable the widget
  4. Click Save Changes

Step 2: Add to Template

  1. Edit your page or template in Elementor
  2. Search for Breadcrumbs (VT)
  3. Drag the widget to your desired location (typically below the header)
  4. Configure settings and styling
  5. Save the template

Widget Settings

General Settings

SettingDescriptionDefault
Home TextText displayed for the home linkHome
Show Home LinkInclude home page in breadcrumbsYes
SeparatorCharacter between breadcrumb items/ (slash)
Show Current PageDisplay the current page nameYes
Max DepthMaximum number of levels to display10

Separator Options

  • / – Slash
  • > – Greater than
  • – Arrow
  • | – Pipe
  • · – Dot
  • Custom – Enter your own separator

Structure Options

SettingDescriptionDefault
Include Post Type ArchiveShow archive link before single postsYes
Show Parent PostsDisplay hierarchical parent chainYes
Include Taxonomy TermsAdd category/taxonomy terms to trailNo
Taxonomy Field KeyVoxel taxonomy field key (e.g., job-category)Empty
Show Parent TermsInclude parent taxonomy termsYes
Prefix TextOptional text before breadcrumbsEmpty
Suffix TextOptional text after breadcrumbsEmpty

SEO & Schema

SettingDescriptionDefault
Enable Schema MarkupAdd JSON-LD structured data for search enginesYes
Add Nofollow to LinksAdd rel=”nofollow” to all breadcrumb linksNo

Styling Options

Link Styling

  • Link color (normal and hover)
  • Typography settings
  • Text decoration
  • Hover effects

Current Page Styling

  • Text color
  • Typography

Separator Styling

  • Separator color
  • Size
  • Spacing
  • Opacity

Container Styling

  • Background color/gradient
  • Padding and margin
  • Border and border radius
  • Box shadow
  • Alignment (left, center, right)

Using with Voxel Taxonomies

To include Voxel taxonomy terms in your breadcrumbs:

  1. Enable “Include Taxonomy Terms”
  2. Enter your taxonomy field key (e.g., “job-category” or “listing-type”)
  3. Optionally enable “Show Parent Terms” for hierarchical taxonomies

The breadcrumbs will show the term hierarchy leading to the current post.


Use Cases

Directory Listings

Show category hierarchy: Home > Restaurants > Italian > Pizza Place

Documentation Sites

Help users navigate docs: Home > Getting Started > Installation

E-commerce

Display product category path: Home > Electronics > Phones > iPhone

Blog Posts

Show article location: Home > Blog > Technology > Article Title


Troubleshooting

Breadcrumbs Not Showing

  • On the homepage, only the home link shows (this is expected)
  • Verify the widget is enabled in Toolkit settings
  • Check that the widget is added to the correct template

Taxonomy Terms Not Appearing

  • Verify the taxonomy field key is correct
  • Check that the post has terms assigned
  • Ensure “Include Taxonomy Terms” is enabled

Wrong Page Hierarchy

  • Check page parent settings in WordPress
  • For custom post types, verify hierarchical structure
AI Assistant