The SEO Framework · KB

★︎ Start with TSF
  • Extensions
  • Documentation
  • Pricing
  1. Home
  2. Knowledge Base
  3. Breadcrumb shortcode

Breadcrumb shortcode — Contents

  • Basic syntax
    • Separator attribute
    • Home attribute
    • Title attribute
    • Class attribute

Breadcrumb shortcode

Published on November 22, 2023
Revised on March 12, 2026

TSF v5.0 added breadcrumbs to every post, page, term, and archive. These are outputted for search engines via structured data, but you can also output them directly on your site via a shortcode.

Basic syntax

The most basic form of the shortcode:

Shortcode: [tsf_breadcrumb]
  1. Home
  2. Knowledge Base
  3. Breadcrumb shortcode

Separator attribute

You can add a custom separator to the breadcrumb:

Shortcode: [tsf_breadcrumb sep="👉"]
  1. Home
  2. Knowledge Base
  3. Breadcrumb shortcode

Please note that the separator is added via the CSS content property. HTML-encoded entities, like •, won’t work. And, because WordPress sometimes outputs backward solidi (\) incorrectly, you may need to add two backslashes to use CSS-encoded Unicode. So, for a bullet (•), you’d have to use [tsf_breadcrumb sep="\\2022"].

WordPress is perfectly capable of storing Unicode since version 4.2. So, to work around all these issues, we recommend inserting special entities directly:

Shortcode: [tsf_breadcrumb sep="•"]
  1. Home
  2. Knowledge Base
  3. Breadcrumb shortcode

Home attribute

To rename the first breadcrumb entry, use the “home” attribute:

Shortcode: [tsf_breadcrumb home="TSF Home"]
  1. TSF Home
  2. Knowledge Base
  3. Breadcrumb shortcode

Any attributes can be combined in a single shortcode, here, we change the home label and the separator:

Shortcode: [tsf_breadcrumb home="TSF Home" sep="⇒"]
  1. TSF Home
  2. Knowledge Base
  3. Breadcrumb shortcode

Title attribute

You can choose which title type to use for breadcrumb items. By default, the shortcode uses the setting configured under SEO Settings → Schema.org → Breadcrumbs.

To override the setting, use [tsf_breadcrumb title="meta"] to consider meta titles which may include custom overrides, or [tsf_breadcrumb title="page"] to use plain page titles.

Class attribute

Finally, you can change the class. You’ll need this if you want to output a different type of separator (we did that without telling you for the examples above). The syntax is as follows, and is meant for developers that implement custom CSS: [tsf_breadcrumb class="my-example-class"]

Filed Under: Features, Structured Data

Related articles

  • Features

    • Advanced Query Protection
    • Robots.txt blocks
    • All you must know about sitemaps
    • Explaining the description generator
    • Structured data supported by The SEO Framework
  • Structured Data

    • WooCommerce integration

Commercial

The SEO Framework
Trademark of CyberWire B.V.
Leidse Schouw 2
2408 AE Alphen a/d Rijn
The Netherlands
KvK: 83230076
BTW/VAT: NL862781322B01

Twitter  GitHub

Professional

Pricing
About
Support
Terms and Conditions
Refund Policy

Editorial

Knowledge Base
Release Notes
Feature Highlights
Blog
Privacy Policy

Practical

TSF on WordPress
TSF on GitHub
TSFEM on here
TSFEM on GitHub
Deploy Troy

On the first page in 2026 › The SEO Framework