Run Shortcode on Widget Title

Learn how to run shortcodes in widget titles in WordPress with a simple filter. Add custom formatting like bold text using shortcodes in widget titles for more flexibility.

By default, WordPress does not execute shortcodes inside widget titles. However, if you want to add custom styling or functionality within a widget title using shortcodes, there is a simple way to achieve this by adding a filter to the widget_title hook.

How to Enable Shortcodes in Widget Titles

To allow shortcodes to run inside widget titles, you can add the following code to your theme’s functions.php file or in a custom plugin:

add_filter( 'widget_title', 'do_shortcode' );

By using the do_shortcode function, WordPress will process any shortcodes you place within a widget title, giving you more flexibility in how your titles appear.

Example: Adding a Bold Shortcode to Widget Title

Let’s say you want to add a custom shortcode to make part of your widget title bold. Here’s how you can do it:

Step 1: Use the [b] Shortcode in Your Widget Title

In your widget title, you can use the [b] shortcode like this:

Make my title [b]bold[/b]

However, for this to work, we need to define the [b] shortcode and make it apply bold formatting.

Step 2: Add a Shortcode to Make Text Bold

To define the [b] shortcode, we can add a custom function to our functions.php file that wraps the content in HTML <strong> tags:

/**
 * Shortcode to make content bold.
 *
 * This function takes the content passed between the shortcode tags and wraps it 
 * in HTML  tags, making the text bold. It can be used in widget titles or 
 * anywhere shortcodes are processed in WordPress.
 *
 * @param array $atts Attributes passed to the shortcode. Not used in this case.
 * @param string $content Content enclosed within the shortcode tags.
 * @return string The content wrapped in  tags for bold styling.
 */
function boldify( $atts, $content = "" ) {
    return "$content";
}

// Register the [b] shortcode, which makes text bold.
add_shortcode( 'b', 'boldify' );

// Ensure that shortcodes are processed in widget titles.
add_filter( 'widget_title', 'do_shortcode' );

This function creates the [b] shortcode and processes the content between the shortcode tags, wrapping it in <strong> tags to make the text bold. The add_shortcode function registers this shortcode, and the filter do_shortcode ensures it works inside the widget title.

Sample Output

Once you’ve added the code and updated your widget title to include the [b] shortcode, the output will look like this:

Make my title bold

In this example, the word “bold” will be displayed in bold inside the widget title, thanks to the custom shortcode.

Why Use Shortcodes in Widget Titles?

Running shortcodes inside widget titles allows you to add dynamic or custom styling to your widget titles without modifying the theme files. This can be especially useful for adding custom formatting like bold, italic, or even embedding dynamic data using shortcodes.

Conclusion

By adding a simple filter to the widget_title hook, you can enable shortcodes inside your widget titles, giving you more control over how titles are displayed. Whether you’re adding custom styling or more complex functionality, this method provides a clean and flexible way to enhance your widget titles.

Remember to always test your shortcodes and widget titles to ensure they render correctly across your site. This approach is safe, update-proof, and keeps your code organized within your theme or plugin files.