--- title: "How to Add Breadcrumbs in WordPress (With Breadcrumb Schema)" url: https://nexterwp.com/blog/how-to-add-breadcrumbs-in-wordpress/ date: 2026-07-13 modified: 2026-07-13 author: "Aditya Sharma" description: "Learn how to add breadcrumbs in WordPress using a plugin, a Gutenberg block, or code, then enable breadcrumb schema so Google and AI search can read your site structure." categories: - "WordPress" image: https://nexterwp.com/wp-content/uploads/2026/05/9wdr3k-1024x538.jpg word_count: 2335 --- # How to Add Breadcrumbs in WordPress (With Breadcrumb Schema) #### Key Takeaways - Breadcrumbs are the small navigation links that show the path from your homepage to the current page, like Home > Blog > WordPress > This Post.- You can add them three ways: a free Gutenberg breadcrumb block, an SEO plugin like Rank Math, or your theme and a small code snippet.- The visual breadcrumb and the BreadcrumbList schema are two different things. Google reads the schema, not the on-page links, to show the path in search results.- Rank Math generates BreadcrumbList structured data automatically once its Schema module is on. Always confirm it with Google's Rich Results Test.- Run only one breadcrumb source at a time so you do not ship duplicate schema.   Picture landing on a product page three levels deep in a store, or a blog post buried under a couple of category levels. There is no quick way to tell where you are or how to climb back up, so most people hit the browser back button and leave. Breadcrumbs close that small but costly gap. They are the row of links near the top of a page that shows the path from your homepage to where you are right now, for example Home > Blog > WordPress > This Post. If I am setting up a new WordPress site, breadcrumbs are one of the first things I switch on. They help visitors move around, reduce the chance of a quick exit, and hand Google the BreadcrumbList structured data it uses to show your page path in search results. This guide is for site owners, developers, and agencies who want to add breadcrumbs in WordPress the right way, with the schema that actually makes them show up in search. We will cover a free Gutenberg block, an SEO plugin, your theme, and how to verify the schema in Google's Rich Results Test. Table of Contents ## What Are WordPress Breadcrumbs and Why Do They Matter for SEO? Breadcrumbs are a navigation element that shows a user's location within a website's structure. A typical breadcrumb trail looks like this: **Home > Blog > WordPress Tips > How to Add Breadcrumbs**. Each item is a link back to that level of the site, so people can jump up a level without pressing the back button. For SEO, breadcrumbs do three concrete things: - **BreadcrumbList schema in search results**: breadcrumbs can output structured data (BreadcrumbList JSON-LD) that Google reads to display the page's path below your title in search results. That can lift click-through rates without changing your ranking position. - **Internal link reinforcement**: every breadcrumb is a contextual internal link connecting a page to its parent categories, which helps Google understand which pages sit under which sections of your site. - **Lower bounce rate**: visitors who land on deep pages get a clear path back up the structure. When people can explore instead of leaving, average session depth improves. Google supports breadcrumbs as a documented search result enhancement, yet they remain one of the most skipped on-page SEO features on WordPress sites. That makes them an easy win. ***Also Read:** If you would rather compare dedicated tools, see our roundup of the [best breadcrumb plugins for WordPress](https://nexterwp.com/blog/breadcrumb-plugins-for-wordpress/) before you pick a method.* ### Types of WordPress Breadcrumbs There are three breadcrumb types you will run into: - **Location-based**: shows the static hierarchy from homepage to current page (Home > Category > Post). This is the most common type and the one Google displays in search results. - **Attribute-based**: used in WooCommerce to show product attributes or filter paths (Home > Shoes > Running > Men's). Useful for stores with deep product taxonomies. - **History-based**: tracks the pages a visitor actually viewed, similar to browser history. Avoid this type, since it changes per visitor and confuses search engines. For most WordPress sites, location-based breadcrumbs are the correct choice. ## Before You Add Breadcrumbs: What You Need - **WordPress 6.0 or later** (the steps below work the same on WordPress 6.x and 7.0) - **Admin access** to your WordPress dashboard - **A block-compatible theme** for Methods 1 and 2 (any modern theme qualifies) - **An SEO plugin such as Rank Math** for Method 2 (the free version is enough) - No coding for Methods 1 or 2; Method 3 needs basic theme familiarity ## Method 1: Add Breadcrumbs with a Free Gutenberg Block If you build in the block editor, you can add a breadcrumb trail without a separate SEO plugin. **[Nexter Blocks](https://nexterwp.com/nexter-blocks/)**, a Gutenberg block plugin by POSIMYTH, includes a Breadcrumb block in its free version. It renders a clean, styled breadcrumb trail and generates the trail automatically from the current page's position, so there is no manual path to configure. ![Nexter Blocks page showing 90+ Gutenberg blocks including the Breadcrumb block](https://nexterwp.com/wp-content/uploads/2026/05/zPToX9kwHNB2aT-U6x2hxIyuBODL73gqvQkkwKWePxCVMrAK0EGZSJCRxcvNQGDa_fdJZpO_ODcIJvh2V1omZA-scaled.png)Nexter Blocks includes a Breadcrumb block in its free tier, alongside 90+ Gutenberg blocks. ### Step 1: Install and Activate Nexter Blocks - In your WordPress dashboard, go to **Plugins > Add New Plugin**. - Search for **Nexter Blocks** (WordPress.org slug: `the-plus-addons-for-block-editor`). - Click **Install Now**, then **Activate**. Nexter Blocks works with any WordPress theme, so you do not need the Nexter Theme to use the Breadcrumb block. ### Step 2: Add the Breadcrumb Block - Open any page, post, or template in the block editor. - Click the **+ (Add Block)** button, or type `/breadcrumb` in the editor. - Select the **Breadcrumb** block from Nexter Blocks. - The block builds the correct trail from the current page's position in your site structure. No manual setup needed. To show breadcrumbs across your whole site rather than one page at a time, add the block to a Header or Single Post template in your block theme's Site Editor (**Appearance > Editor**), or use a theme builder that supports template parts. One honest note on schema: the Breadcrumb block renders the visual trail. To also output the BreadcrumbList structured data that Google reads, enable breadcrumb schema in your SEO plugin (Rank Math does this automatically, covered next) and confirm it with the Rich Results Test. Keeping the visual trail and the schema in sync is what makes breadcrumbs appear in search results. ***Also Read:** New to the block editor? Our list of the [best Gutenberg plugins for WordPress](https://nexterwp.com/blog/best-gutenberg-plugins/) covers the add-ons worth installing first.* ## Method 2: Enable Breadcrumbs with Rank Math SEO (Automatic Schema) If you already run an SEO plugin, this is usually the fastest route to breadcrumbs plus schema. Rank Math has more than 4 million active installs on WordPress.org, so many sites already have it. Enabling breadcrumbs takes about two minutes, and it generates the BreadcrumbList structured data automatically once the Schema module is active. No separate schema plugin or hand-written JSON-LD required. ### Step 1: Turn On Breadcrumbs in Rank Math - Go to **Rank Math SEO > General Settings**. - Click the **Breadcrumbs** tab. - Toggle **Enable Breadcrumbs Function** to ON. - Set your separator (default is ») and the home label (default is "Home"). - Click **Save Changes**. ![Rank Math SEO breadcrumbs settings page with the Enable Breadcrumbs Function toggle turned on](https://nexterwp.com/wp-content/uploads/2026/05/rank-math-breadcrumbs-settings.jpg)Rank Math generates BreadcrumbList schema automatically once breadcrumbs are enabled and the Schema module is on. ### Step 2: Display the Breadcrumbs Rank Math enables breadcrumbs at the data level but needs one display step to show them on the page. You have two options. **Option A, shortcode block (no code):** open a page or template in the block editor, add a **Shortcode** block, and paste `[Home](https://nexterwp.com) - `. The trail renders at that spot. **Option B, theme template:** add `` to your theme's `single.php` or header template. If you prefer no PHP editing, drop the shortcode block into your Single Post template in the Site Editor instead. ## Method 3: Use Your Theme's Built-In Breadcrumbs or a Snippet Many WordPress themes include a breadcrumb toggle. In **Astra**, for example, go to **Appearance > Customize > Breadcrumb**, enable it, and choose the position. Kadence and OceanWP offer similar options in their own panels. Some themes also register breadcrumb support so an SEO plugin can hook into it with `add_theme_support( 'rank-math-breadcrumbs' )`. The catch is schema. Most theme-built breadcrumbs display the trail but do not output BreadcrumbList structured data, so Google may not show the path in search results even though the breadcrumb looks fine on the page. If search appearance matters, lean on Method 1 for the display and Method 2 (or your SEO plugin) for the schema. **For Nexter Theme users:** the recommended setup is Method 1, the free [Nexter Blocks](https://nexterwp.com/nexter-blocks/) Breadcrumb block for the display, paired with your SEO plugin for the schema. It integrates natively and gives you full style control from the block settings. ## How to Add Breadcrumb Schema (BreadcrumbList JSON-LD) This is the part most guides gloss over. The breadcrumb links people see and the breadcrumb schema search engines read are two separate things. The schema is a small block of JSON-LD called **BreadcrumbList**, defined by [schema.org](https://schema.org/BreadcrumbList). It lists each step of the path as an ordered set of items, and it is what lets Google show the path below your title instead of a raw URL. ![schema.org BreadcrumbList reference page describing the structured data type](https://nexterwp.com/wp-content/uploads/2026/05/TSoDq8H4msTGH1QZ9F-5VTDxv_ByAskUFZVWre2BAC-NJHMZs2NmU6Ku_SUEUYrGutkt5ir3dk_ZLzY57Au_Xg-scaled.png)BreadcrumbList is the schema.org type Google reads to render the breadcrumb path in search results. The good news is you rarely have to write it by hand. When you enable breadcrumbs in Rank Math and keep its Schema module on, it outputs the BreadcrumbList JSON-LD for every eligible page automatically. To confirm the markup is live, open any page, view the page source, and search for `BreadcrumbList`. If the term appears, the structured data is being served. ## How to Test If Your Breadcrumbs Show in Google Adding breadcrumbs is step one. Confirming Google can read the structured data is step two. Two tools handle it. **Google Rich Results Test:** - Go to [Google's Rich Results Test](https://search.google.com/test/rich-results). - Paste the URL of a page where you added breadcrumbs and click **Test URL**. - Look for a **Breadcrumbs** entry in the detected items panel. - A **Valid** status means Google can display the breadcrumb path in search results. ![Google Rich Results Test tool used to validate breadcrumb structured data](https://nexterwp.com/wp-content/uploads/2026/05/WTaB1ZT169qYVOYloB2rVSCmghJ8yP3XyODl-IEo9PFRbShNLp1SD3-D5o2yxxz3XzoufzBs9Qn8FNbM8w0q1g-scaled.png)Paste a URL into Google's Rich Results Test to confirm the breadcrumb markup is valid. **Google Search Console (URL Inspection):** open Search Console, paste a page URL in the inspection bar, and check the **Enhancements** section of the report. A breadcrumb entry with a valid status confirms it is working. For a quick schema-only check, the schema.org validator also flags BreadcrumbList errors. ![Schema.org structured data validator showing BreadcrumbList detected with zero errors](https://nexterwp.com/wp-content/uploads/2026/05/schema-validator-breadcrumblist.jpg)A clean validator result: BreadcrumbList detected with no errors. If you see a warning, the usual cause is a mismatch between the breadcrumb trail shown to users and the JSON-LD. Make sure the categories and hierarchy in your breadcrumbs match your actual URL structure. ## Do Breadcrumbs Still Matter for AI Search? They matter more, not less. AI answer engines like ChatGPT, Perplexity, and Google's AI Overviews lean on structured data to understand how the pages on a site relate to each other. A clean BreadcrumbList tells them where a page sits in your topic hierarchy, which makes your content easier to cite accurately. Breadcrumb schema is one piece of that larger picture. If you are optimizing for AI search more broadly, [RankReady](https://store.posimyth.com/plugins/rankready/) adds the wider layer: Speakable, FAQPage, and HowTo schema, an llms.txt file, AI-crawler controls, and citation tracking for bots like ChatGPT-User and PerplexityBot. It is free and GPL-licensed. To be clear, RankReady does not generate breadcrumb schema itself, so pair it with Rank Math for that piece and let each tool do the job it is built for. ***Also Read:** Want the full picture on AI-era SEO tooling? Compare the [best WordPress SEO plugins using AI](https://nexterwp.com/blog/best-wordpress-seo-plugins-using-ai/).* ## Common WordPress Breadcrumb Mistakes (and How to Avoid Them) - **Schema not enabled**: the breadcrumbs display but no BreadcrumbList JSON-LD exists in the source. Confirm your SEO plugin's breadcrumb schema is on, then re-test. - **Breadcrumbs on the homepage**: a trail that shows only "Home" on the homepage adds nothing. Most tools let you hide breadcrumbs on the front page, so switch that off. - **Path does not match the URL**: Google expects the breadcrumb hierarchy to match your real URL path. If the URL is `/blog/category/post/` but the trail shows Home > Post, the structured data gets ignored. Check your permalinks and category assignments. - **Two breadcrumb sources at once**: running Rank Math breadcrumbs alongside a separate breadcrumb plugin creates duplicate BreadcrumbList data, and Google may ignore both. Pick one and disable the other. - **No styling**: unstyled breadcrumbs read as plain text and get missed. The Nexter Blocks Breadcrumb block gives you typography, color, and separator controls without writing CSS. ## Frequently Asked Questions ### Do I need a plugin to add breadcrumbs in WordPress? Not always. Some themes include a breadcrumb toggle, and you can add them with a code snippet. But a free block or an SEO plugin is the simplest route, and it is the only easy way to also get the BreadcrumbList schema that makes breadcrumbs appear in search results. ### Do breadcrumbs help SEO? Yes, in two ways. They strengthen internal linking and site structure, and their BreadcrumbList schema can show your page path in search results, which often improves click-through rate. They are not a direct ranking factor, but they support the signals that are. ### Why are my breadcrumbs not showing in Google search results? The most common reason is missing or invalid BreadcrumbList schema. Run the page through Google's Rich Results Test. If no breadcrumb item is detected, enable breadcrumb schema in your SEO plugin. Also remember that Google can take time to recrawl the page before the change appears. ## Wrapping Up: Add Breadcrumbs to WordPress Today Adding breadcrumbs in WordPress is a 5 to 10 minute job that lowers bounce rate, reinforces your internal link structure, and gives Google the BreadcrumbList data it needs to show your page path in search results. Choose **Method 1** (the free Nexter Blocks Breadcrumb block) for a Gutenberg-native display with full style control, **Method 2** (Rank Math) when you want automatic BreadcrumbList schema, or **Method 3** if your theme already handles it and search appearance is not a priority. Whichever you pick, enable the schema and confirm it in the Rich Results Test. ## Suggested Reading - [5 Best Breadcrumb Plugins for WordPress](https://nexterwp.com/blog/breadcrumb-plugins-for-wordpress/) - [12 Best Gutenberg Plugins for WordPress](https://nexterwp.com/blog/best-gutenberg-plugins/) - [5 Best WordPress SEO Plugins Using AI](https://nexterwp.com/blog/best-wordpress-seo-plugins-using-ai/) - [7 Best WordPress SEO Friendly Themes](https://nexterwp.com/blog/best-wordpress-seo-friendly-themes/) - [WordPress 7.0: What's Changing for Block Builders](https://nexterwp.com/blog/wordpress-7-block-builders/) #### Stay updated with Helpful WordPress Tips, Insider Insights, and Exclusive Updates – Subscribe now to keep up with Everything Happening on WordPress! Subscribe