SEO & AI search · Info
Yoast SEO Breadcrumbs Settings Explained: What Each Option Does

Short answer
Yoast SEO breadcrumb settings live under Yoast SEO > Settings > Advanced > Breadcrumbs. They set the separator, homepage label, prefixes, 404 text and which taxonomy appears for each post type. A block, shortcode or theme code then prints the trail on your pages.
Key takeaways
- Find the options in Yoast SEO > Settings > Advanced > Breadcrumbs.
- The settings control what the trail says, not where it appears.
- Add the trail with the Yoast block, the wpseo_breadcrumb shortcode or a PHP snippet.
- Pick Category for posts so the trail mirrors your site structure.
- Use the per-post Breadcrumbs title field to shorten long page titles.
- Yoast adds breadcrumb data to its schema, which Google can show in results.
What do the Yoast SEO breadcrumbs settings do?
The Yoast SEO breadcrumbs settings control the text, separator, prefixes and taxonomy paths of the breadcrumb trail Yoast builds, and whether your theme can show it.
Breadcrumbs are the small navigation trail near the top of a page, such as Home » Blog » WordPress » This post. They help visitors see where they are and give search engines a clear picture of your site structure.
Yoast SEO can build that trail for you.
The settings decide what the trail says and how it is built. They do not, on their own, decide where it appears. Your theme, a block or a short PHP snippet does that part.
This page walks through every option in the order Yoast shows it. If you want the wider picture of the plugin first, see Yoast SEO settings explained.
Where are the breadcrumbs settings in Yoast SEO?
In current versions of Yoast SEO, go to Yoast SEO > Settings > Advanced > Breadcrumbs in your WordPress dashboard.
Older versions kept the same options under Search Appearance, on a Breadcrumbs tab. If you see that screen, your plugin is out of date. Update it before changing anything, because the labels and layout have changed.
Yoast documents the page in its help center article on breadcrumbs settings. The options are the same in the free and Premium versions.
You need an administrator account to see this page. Editors and authors can still set a per-post breadcrumb title, which is covered further down.
What does the separator setting change?
The separator is the character placed between each item in the trail, and Yoast uses the » symbol by default.
You can type any character or short string. Common choices are:
- » – the default, compact and easy to read.
- / – looks like a URL path and suits technical sites.
- › or > – a clean arrow.
- | – a vertical bar, which some designers prefer.
The separator is plain text in the output. If you want an icon or special styling, leave a simple character here and style it with CSS instead.
Keep it short. A long separator wastes space on mobile, where breadcrumbs often wrap onto two lines.
What is the anchor text for the homepage?
This field sets the label of the first link in the trail, which points to your homepage, and Yoast uses Home by default.
Many sites change it to the brand name. For example, WPLegible » Guides » This page looks more personal than Home » Guides » This page.
Keep the label short. One or two words is enough, since visitors already know the first link goes to the start of the site.
If your site runs in more than one language, a translation plugin may need to translate this string. That is a common source of mixed-language breadcrumbs.
What do the prefix settings do?
The prefix fields add fixed text before the trail on normal pages, archive pages and search result pages, and they are empty by default.
There are three related fields:
- Prefix for the breadcrumb path. Text shown before the whole trail on every page, such as You are here:.
- Prefix for archive breadcrumbs. Text added before the archive name, such as Archives for before a category or date.
- Prefix for search page breadcrumbs. Text added before the search query, such as You searched for.
Most modern sites leave the main prefix blank. The trail is usually clear without extra words, and the prefix adds clutter on small screens.
The archive and search prefixes are more useful. They tell visitors that the last item is a listing or a search, not a single page.
Breadcrumb for 404 pages. This field sets the last item in the trail when a visitor lands on a missing page, and Yoast fills it with a default like Error 404: Page not found.
You can change it to friendlier text such as Page not found. Only visitors on broken URLs see it, so it matters less than the other options.
If you see this label often in your analytics, the real fix is to find the broken links. Our guide on how to use Yoast SEO redirects explains how to send old URLs to the right place.
What do the blog page and bold last page options do?
The blog page option adds your posts page to the trail when you use a static front page, and the bold option makes the current page bold.
Show blog page in breadcrumbs. This only appears when you set a static homepage under Settings > Reading. When it is on, a post trail looks like Home » Blog » Post title instead of Home » Post title. Turn it on if your blog page is an important section of the site.
Bold the last page. This wraps the final item in bold tags. Most themes style the current item already, so many sites leave it off and use CSS.
The last item in a Yoast trail is not a link, because it is the page the visitor is already on. That is normal and matches how breadcrumbs usually work.
How do the content type and taxonomy settings work?
These settings choose which taxonomy appears in the trail for each post type, and which post type page appears in the trail for each taxonomy archive.
Breadcrumbs for content types. For posts, you usually pick Category. A post then shows Home » Category » Post title.
For products in WooCommerce, you might pick Product categories. If you choose None, the trail skips straight from the home link to the page.
Breadcrumbs for taxonomies. This adds a parent page to taxonomy archives. For example, you can show the Blog page before category archives, giving Home » Blog » Category name.
When a post sits in several categories, Yoast normally uses the first one. With Yoast SEO Premium you can also set a primary category, and the trail uses that one. If a post shows the wrong category, check the primary category in the post's sidebar.
Hierarchical pages follow their parent pages automatically. A child page shows Home » Parent » Child without any setting.
| Setting | Default | What it changes |
|---|---|---|
| Separator | » | Character between trail items |
| Anchor text for homepage | Home | Label of the first link |
| Prefix for breadcrumb path | Empty | Text before the whole trail |
| Prefix for archives | Archives for | Text before archive names |
| Prefix for search page | You searched for | Text before search terms |
| Breadcrumb for 404 page | Error 404 text | Last item on missing pages |
| Show blog page | Off | Adds posts page to the trail |
| Bold the last page | Off | Makes current page bold |
| Content type taxonomy | Varies | Which taxonomy shows for each post type |
| Taxonomy parent | None | Which page shows before taxonomy archives |
| Enable breadcrumbs for your theme | Off | Lets theme code output the trail |
Defaults can change between versions, so check the screen on your site.
What does the enable breadcrumbs for your theme toggle do?
This toggle lets theme code that calls the Yoast breadcrumb function print the trail, so turn it on when you add breadcrumbs through a theme template or theme option.
Some themes have built-in Yoast support. They show a theme setting to use Yoast breadcrumbs, and the toggle must be on for it to work. Other themes need you to add the trail yourself.
There are three common ways to add breadcrumbs to a page:
- The Yoast breadcrumbs block. In the block editor, add the Yoast Breadcrumbs block to a post, page or template. Yoast describes it on its developer site.
- A shortcode. Use
[wpseo_breadcrumb]in a widget, page builder text field or template part. - A PHP snippet. Add Yoast's function to your theme files, ideally in a child theme.
The PHP version from Yoast's guide on implementing breadcrumbs looks like this:
<?php
if ( function_exists( 'yoast_breadcrumb' ) ) {
yoast_breadcrumb( '<p id="breadcrumbs">', '</p>' );
}
?>
Place it in a template such as single.php or page.php, usually just above the title. Edit a child theme so a theme update does not wipe your change.
If you build with a page builder, the shortcode is usually the easiest option. The guide on using Yoast SEO with Elementor covers how Yoast fits into that workflow.
Can you change the breadcrumb title for one post?
Yes, each post and page has a Breadcrumbs title field in the Yoast sidebar or meta box, under the Advanced section.
This is handy when a page has a long title. A page called The Complete Guide to Choosing WordPress Hosting in Small Business Settings can appear in the trail as Hosting guide.
The field only changes the breadcrumb label. It does not change the page title, SEO title or URL. Yoast explains it in its help article on the breadcrumbs title setting.
Taxonomy terms such as categories have a similar field on their edit screens.
Do Yoast breadcrumbs help SEO?
Breadcrumbs give search engines structured data about your site hierarchy, and Google can show a breadcrumb path in search results instead of the raw URL.
Yoast adds breadcrumb information to the schema markup it prints on each page. Google reads this as BreadcrumbList data. Google explains how it uses that markup in its breadcrumb structured data documentation.
You can check the output with Google's Rich Results Test. If you run two SEO plugins, or a theme that prints its own breadcrumb schema, you may get duplicate data. Our page on using Rank Math and Yoast together explains why that is a bad idea.
Breadcrumbs are a small signal, not a ranking trick. Their main value is clearer navigation, a tidy site structure and nicer search snippets.
Why are Yoast breadcrumbs not showing?
They usually do not show because nothing on the page outputs them, the theme toggle is off, or the theme prints its own breadcrumbs instead.
Work through these checks:
- Is there an output method? The settings alone print nothing. Add the block, shortcode or PHP snippet.
- Is the theme toggle on? Theme integrations and the PHP function need Enable breadcrumbs for your theme.
- Is the theme using its own trail? Some themes, including OceanWP, have their own breadcrumbs. Our OceanWP breadcrumbs settings page shows how to switch them.
- Is a cache serving an old page? Clear your page cache after changes.
- Is the category wrong? Check the primary category and the content type setting.
If the trail still misbehaves, turn on debugging and look for PHP errors near the template you edited. Yoast's support forum on WordPress.org is a good place to search for theme-specific issues.
Which Yoast breadcrumb settings should most sites use?
Most sites do well with a short separator, a brand or Home label, no main prefix, Category for posts and the theme toggle on if the theme needs it.
A simple starting setup:
- Separator: » or /.
- Homepage anchor text: your brand name or Home.
- Prefix for the breadcrumb path: empty.
- Archive prefix: Archives for or empty.
- Show blog page: on, if you use a static front page.
- Posts: Category. Products: Product categories.
- Enable breadcrumbs for your theme: on, if your theme or snippet uses it.
After saving, open a post, a page, a category archive and a search result. Check that each trail makes sense and that every link works. Then test one URL in the Rich Results Test.
If you are still setting up the plugin, follow our Yoast SEO setup guide for the other settings.
Frequently asked questions
Are Yoast breadcrumbs available in the free version?
Yes. Breadcrumbs are part of the free Yoast SEO plugin, including all the settings on the Breadcrumbs page, the block, the shortcode and the PHP function. Premium adds extras such as easier primary category handling and other features, but you do not need it for basic breadcrumbs.
Why do my breadcrumbs show the wrong category?
When a post has several categories, Yoast picks one for the trail. Set a primary category in the post sidebar so Yoast knows which one to use, and confirm that the content type setting for posts is set to Category rather than another taxonomy or None.
Do I need the theme toggle if I use the Yoast block?
Usually not. The toggle mainly matters for theme integrations and the PHP function in template files. If you only use the block or shortcode and the trail shows correctly, you can leave the toggle as it is. Turn it on if your theme has a setting that relies on Yoast breadcrumbs.
Can I style Yoast breadcrumbs?
Yes. The trail is plain HTML, so you can style it with CSS in the Customizer or your child theme. Target the wrapper element you set in the PHP snippet or the block's class, then adjust font size, colors, spacing and the separator appearance.
Will breadcrumbs replace the URL in Google results?
Google may show a breadcrumb path instead of the full URL when it understands your structure, and Yoast's schema output helps with that. Google decides when to show it, so there is no guarantee for every page or every search.
Sources
- Yoast SEO settings: Breadcrumbs Yoast
- How to implement Yoast SEO breadcrumbs Yoast
- The breadcrumbs title setting Yoast
- Blocks: Breadcrumbs Yoast Developer
- Breadcrumb structured data Google Search Central
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.


