Surbma | Yoast SEO Breadcrumb Shortcode icon
Actively maintained Tested with WP 7.1 #4 in breadcrumb Freemium

Surbma | Yoast SEO Breadcrumb Shortcode

A simple shortcode to include Yoast's breadcrumb function everywhere on your WordPress website.

Active installs3K+1K+ tier
Downloads · 30d1.7K▲ 5.1× vs prev. 30d
Rating4.2/59 reviews
Health score80/100Excellent
All-time downloads41.5KSince Jan 2015
Support resolved—No recent threads
RequiresWP 5.0PHP 7.4+
Downloads · 7d1.3K▲ 12.1× week over week
Our verdict

Safe pick

Yes — Surbma is a safe, well-maintained plugin to use in 2026. It runs on 3K+ sites, is rated 4.2/5 and was last updated 6 days ago, and scores 80/100 on our health check.

  • Actively developed — last update 6 days ago
  • Tested with the latest WordPress (7.1)
  • Momentum — downloads up 407.6% vs the previous 30 days

How does it stack up?

Side-by-side on installs, updates, ratings & support

Daily downloads

138276414Aug 19Oct 2Nov 16
Yesterday97
Daily average (1y)18
Peak day649Mar 27, 2026
Last 12 months6.7K

Download spikes usually follow a new release — each site that auto-updates counts as a download.

Rankings

Where Surbma stands today

WordPress.org search rankings

Live position in the plugin search, top 100
KeywordPositionCompeting pluginsCategory
breadcrumb #8 1,012 Best breadcrumb plugins →
shortcode #16 10,000 Best shortcode plugins →
wordpress seo #70 9,002 Best wordpress seo plugins →
Yoast #7 2,937 Best Yoast plugins →
Yoast SEO #10 2,773 Best Yoast SEO plugins →

Version adoption

Share of active sites per release.

  • 1.251.3%
  • 1.143.6%
  • 1.05.1%

Rating breakdown

★★★★★★★★★★ 4.2 from 9 reviews

  • 5★66.7%
  • 4★11.1%
  • 3★11.1%
  • 2★0.00%
  • 1★11.1%

About Surbma | Yoast SEO Breadcrumb Shortcode

From the official readme · v1.2.1

Description

A simple shortcode to include Yoast SEO’s breadcrumb function everywhere on your WordPress website. You have to install and activate the WordPress SEO by Yoast plugin and enable breadcrumb option to use this shortcode.

With this shortcode you can put Yoast’s fantastic breadcrumb feature manually into every post and page or even into custom post types. If your theme supports it, you can use this shortcode in your widget areas with the Text widget.

The shortcode:
[yoast-breadcrumb]

There are two parameters for this shortcode:

  1. before – The code that your breadcrumb should be prefixed with. Default value: <div class="breadcrumb" itemprop="breadcrumb">
  2. after – The code that should be added on the back of your breadcrumb. Default value: </div>

You can read more informations about Yoast’s breadcrumb function here: Yoast Breadcrumbs – WordPress Breadcrumbs

Do you want to contribute or help improving this plugin?

You can find it on GitHub: https://github.com/Surbma/surbma-yoast-breadcrumb-shortcode

You can find my other plugins and projects on GitHub:

https://github.com/Surbma

Please feel free to contribute, help or recommend any new features for my plugins, themes and other projects.

Do you want to know more about me?

Visit my webpage: Surbma.com

Installation

  1. Upload surbma-yoast-breadcrumb-shortcode folder to the /wp-content/plugins/ directory
  2. Activate the Surbma – Yoast SEO Breadcrumb Shortcode plugin through the ‘Plugins’ menu in WordPress
  3. That’s it. Now you can use the shortcode. 🙂

Changelog

1.2.1

Release date: 2026-11-11

  • FIX – Sanitized shortcode before and after attributes with wp_kses to prevent stored XSS.
  • TWEAK – Replaced extract() with explicit shortcode attribute handling.
  • TWEAK – Hardened Yoast SEO option checks to avoid undefined index notices.
  • TWEAK – Tested with WordPress 7.1 version.

1.2

Release date: 2026-03-27

  • TWEAK – Updated minimum PHP version requirement to 7.4.
  • TWEAK – Tested with WordPress 6.9 version.

1.1

  • Release date: 2019-05-09
  • TWEAK – Minor changes in description.
  • TWEAK – New shorter version numbering.
  • Tested up to WordPress 5.2 version.
  • Tested up to Yoast SEO 11.x version.
  • Added minimum PHP requirement.

1.0.4

  • Fixed compatibility with Yoast SEO 7.0.x versions.
  • Tested up to WordPress 4.9 version.

1.0.3

  • Fixed shortcode’s return function. Props to danieledesantis
  • Tested up to WordPress 4.2 version.
  • Description text modifications.

1.0.2

  • Fix localization.
  • Prevent direct access to the plugin.

Full changelog on WordPress.org →

For developers

Is this your plugin? Show off the numbers.

Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.

Active installs badge Rating badge Health score badge

Best Surbma alternatives

All breadcrumb plugins →
Alternatives
Rank Plugin Active installs Rating Updated Health
1 Breadcrumb NavXT Breadcrumb NavXT Adds breadcrumb navigation showing the visitor's path to their current location. by John Havlik 700K+ ★★★★★★★★★★ 4.6 (132) 3 months ago 77
2 Flexy Breadcrumb Flexy Breadcrumb Flexy Breadcrumb is a lightweight, responsive, and SEO-optimized breadcrumb plugin that… by PressTigers 10K+ ★★★★★★★★★★ 4.7 (20) 2 weeks ago 89
3 Breadcrumb –  Breadcrumb for WooCommerce and Custom Post Types Breadcrumb Super light weight & easy breadcrumb navigation for wordpress site. by PickPlugins 10K+ ★★★★★★★★★★ 4.6 (34) 11 months ago 60
5 Breadcrumb Block Breadcrumb Block A simple breadcrumb trail block that supports JSON-LD structured data and is compatible… by Phi Phan 2K+ ★★★★★★★★★★ 5 (14) 3 months ago 73
6 Catch Breadcrumb Catch Breadcrumb Catch Breadcrumb lets you display Breadcrumb Navigation anywhere on your website elegantly. by Catch Themes 2K+ ★★★★★★★★★★ 5 (5) 6 months ago 62
7 JSON-LD Breadcrumbs JSON-LD Breadcrumbs Adds JSON-LD based breadcrumb schema to your site visible only to the Search Engines such… by Pratik Chaskar 1K+ ★★★★★★★★★★ 5 (2) 3 months ago 67
8 RDFa Breadcrumb RDFa Breadcrumb An easy template tag for showing a breadcrumb menu on your site and on google search… by Nitin Yawalkar 600+ ★★★★★★★★★★ 4.1 (7) 11 years ago 35
9 Breadcrumb TMC Breadcrumb TMC Use [breadcrumb-tmc] shortcode to display the breadcrumb trail. by wptmcdev 400+ ★★★★★★★★★★ 5 (1) 2 years ago 34
10 Menu Breadcrumb Menu Breadcrumb Generate a breadcrumb trail from a WordPress Menu by Jon Christopher 300+ ★★★★★★★★★★ 5 (2) 11 months ago 48
11 Breadcrumb based on URL Breadcrumb based on URL This Breadcrumb will show the permalink url, also clickable all part by Dear 300+ ★★★★★★★★★★ 5 (2) 6 months ago 61

FAQ

Surbma: quick answers

Straight answers, pulled from live WordPress.org data.

Live data from WordPress.org · checked Nov 17, 2026

Is Surbma free?

Yes. Surbma is free to download and use from the official WordPress.org plugin directory. The developer also sells premium add-ons or a Pro version with extra features.

Is Surbma safe to use in 2026?

Yes — Surbma is a safe, well-maintained plugin to use in 2026. It runs on 3K+ sites, is rated 4.2/5 and was last updated 6 days ago, and scores 80/100 on our health check.

How many websites use Surbma?

Surbma is active on 3K+ WordPress websites and has been downloaded 41,497 times since it launched in January 2015. It was downloaded 1,670 times in the last 30 days.

Does Surbma work with WordPress 7.1?

Yes. The developer has tested Surbma up to WordPress 7.1.4, the latest release. It requires WordPress 5.0 or newer.

What PHP version does Surbma need?

Surbma requires PHP 7.4 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.

When was Surbma last updated?

The latest version, 1.2.1, was released on November 11, 2026 (6 days ago).

Who makes Surbma?

Surbma is developed and maintained by Surbma.

What are the best alternatives to Surbma?

The most popular alternatives to Surbma are Breadcrumb NavXT (700K+ installs), Flexy Breadcrumb (10K+ installs) and Breadcrumb (10K+ installs).

Powered by PageForge

Want thousands of pages that rank like these? Build them in an afternoon.

This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.

  • CSV, Google Sheets & API data sources
  • AI content, schema & internal links per page
  • Works with Elementor, Gutenberg, Yoast & Rank Math
  • Free on WordPress.org — no credit card
Sarah is here to help!
Hi there! 👋 Need help finding what you're looking for?
Sarah
Sarah
Online & Ready to Help
Hi there! 👋 Need help finding what you're looking for?

We'll use this to continue our conversation

Just now ✓ Verified

Join 500+ SEO Pros Scaling Their Strategy

Get exclusive programmatic SEO tactics, AI content workflows, and the latest PageForge updates delivered straight to your inbox. Stay ahead of the algorithm.

We care about your data in our privacy policy.