• E-Commerce
    • eCommerce
    • Amazon FBA
    • Dropshipping
  • Marketing
    • Digital Marketing
    • Social Media
    • Email Marketing
  • Blogging
    • Blogging & Niche Websites
    • Artificial Intelligence
    • SEO
    • Monetization
    • Affiliate Marketing
  • Make Money
    • Side Hustles
    • Self Publishing
    • Start a Business
    • Make Money Online
  • Stories
    • Podcasts
    • Success Stories
  • Help & Guides
    • Start Here
    • Tools
    • About
    • Archives
    • Contact
    • Advertise On Niche Pursuits
Wordpress

How to Add Shortcode in WordPress: A Definitive Guide

<a class="txt-link" href="https://www.nichepursuits.com/author/colinshaun77icloud-com/">Colin Linnett</a>

By Colin Linnett

Last updated: July 11, 2022

When you buy something through one of the links on our site, we may earn an affiliate commission.

 

If you want to know how to add shortcode in WordPress, you're probably aware of the convenience they bring when writing and designing your WordPress website.

Shortcodes are a helpful addition, and almost every blogger will use one in some way or another. Whether that's through a WordPress plugin, a theme, or the core of WordPress itself, you'll very likely be using them with WordPress.

The question is, how do you add them?

In this article, I will walk you through a series of ways to add shortcodes in WordPress.

You'll learn:

  • What shortcodes are (with examples)
  • How to create shortcodes in WordPress pages and posts
  • An easy way to add and make them with a WordPress shortcode plugin
  • How to create shortcodes in theme files, Gutenberg blocks, and the sidebar
  • The pros and cons of using them
  • Plus much more

Let's get started.

Contents

  • What Is A Shortcode?
  • Why Were Shortcodes Created For WordPress?
  • WordPress Shortcode Examples
    • Default WordPress Shortcode Examples
  • Various Other WordPress Shortcodes
  • How Do I Insert a Shortcode in WordPress Pages & Posts?
    • Adding a Shortcode in Sidebar Widget Area
    • How to Add A Shortcode in the Classic WordPress Editor
    • Easy Way To Add Shortcode To The WordPress Theme Files
    • Using a WordPress Plugin to Add Shortcodes
  • Shortcodes vs. Gutenberg Blocks
  • How Do I Create a Custom Shortcode in WordPress?
  • Pros & Cons Of Using WordPress Shortcodes
    • Pros
    • Cons
  • Final Thoughts on How To Add Shortcode in WordPress

What Is A Shortcode?

A WordPress shortcode is a code displayed inside a square bracket. The purpose of the code is to offer a convenient and fast way to add dynamic content to WordPress.

You can add the content in pages, posts, and sidebars. They are also widely used with third-party plugins and WordPress themes.

Why Were Shortcodes Created For WordPress?

WordPress lets the user write HTML inside pages and posts, but you can't directly write PHP. WordPress does this as a security feature and to help with avoiding harmful code and discrepancies within the database.

When a developer registers a new shortcode with the WordPress code files, it allows the user to use a range of custom shortcodes to enable certain features on their blog.

If you want to add related posts, a bio box, or display the current year in the footer, you can use a shortcode to signal to WordPress to allow the feature you want to show.

To sum up: It's a safe, fast, convenient, and easy way to display content, boxes, layouts, images, and much more for those who aren't web developers. However, they're so convenient that even web developers use them.

WordPress Shortcode Examples

Let's take a look at some shortcode examples. It will further help you understand what they are and why they're so helpful.

Default WordPress Shortcode Examples

The following six shortcodes are included in WordPress by default:

  • Wrap embedded items with the 'embed' shortcode
  • Show a gallery of images with the ‘gallery' shortcode
  • ‘Audio' shortcode lets you play audio files
  • Offer a series of media files with the ‘playlist' shortcode
  • Wrap captions around content with the ‘caption' shortcode
  • Embed videos by using the shortcode ‘video.'

You can learn more about the default shortcodes in the WordPress plugin handbook.

Various Other WordPress Shortcodes

  • side_bar – displays a sidebar
  • contact_form – shows a contact form
  • related_post – displays a list of related posts
  • button – adds a button to the content area
  • aweber_form_id – shows the Aweber form you created on your page
  • toc – adds a table of contents, like shown towards the beginning of this article

The above examples show how shortcodes are typically displayed but without the square brackets around them.

How Do I Insert a Shortcode in WordPress Pages & Posts?

It's a simple process to add a shortcode to a WordPress page or post, and all it requires is for you to use the shortcode widget.

When you're on the page that you want to add a WordPress shortcode for, select the add block option and search for ‘shortcode' in the search bar.

How To add Shortcode In WordPress

You then select the shortcode widget, and a display box will appear in the content like below:

Shortcode Widget

Enter the shortcode you want to use, update the page, and take a look at a live view to make sure everything is working as it should be.

The shortcode you use will usually be from a third-party plugin or theme. For example, you could have a plugin for a contact form. When setting up the plugin, you will have been provided with a shortcode to enter. You enter that shortcode, and a contact form will show on the page.

Adding a Shortcode in Sidebar Widget Area

Adding a shortcode to the sidebar is another simple task. You add the shortcode using a widget in the sidebar area.

All you need to do is select ‘appearance' in the dashboard menu and select ‘widgets.'

You then locate the sidebar you want to use, click on the plus sign, search for the ‘Text & Media' text widget, and enter the shortcode you want to use.

Shortcodes In Widgets

Then, you need to update and check that it has worked correctly.

Another way to add the shortcode to the sidebar is to follow the above instructions, search for shortcode instead of text and media, and then enter the shortcode you want to use.

How to Add A Shortcode in the Classic WordPress Editor

To add a shortcode using the old classic WordPress editor, you'll need to enter the code manually.

You need to go to the post or page to add the shortcode and paste the code. Then, select the update button, and check to see that everything is working.

Easy Way To Add Shortcode To The WordPress Theme Files

If you want to add a shortcode inside a WordPress theme file, you'll need to add it manually to the theme.php.

The code you will be adding will look like this:

<?php echo do_shortcode(“[your shortcode name goes here]”); ?>

When you use this shortcode in the future, WordPress will run the function and show the outcome.

Of course, you will be messing around with the theme code, so only do this if you're confident because one minor mistake can cause errors on your website.

It's probably a good idea to perform a backup before proceeding.

Using a WordPress Plugin to Add Shortcodes

WordPress Shortcode Plugin

When using WordPress for any reason or specific action, there always seems to be a plugin for the job. Creating a shortcode in WordPress is no different — there's a plugin to help you.

The plugin in question is ‘Shortcode Ultimate.'

Shortcode Ultimate will make it easy for you to add a shortcode block to create sliders, tabs, boxes, buttons, and many more items.

There are over 50 shortcodes on offer with the plugin, and all you need to do to install a shortcode is select the menu bar above the editor and choose the shortcode you want.

The below image shows the shortcodes currently available.

The supported plugin is free to use, regularly updated, works on any theme. If you want to add more features like extra shortcodes or the ability to create custom shortcodes, you can purchase the pro version.

It costs $39 for a single site, $59 for two to five sites, and $99 for unlimited websites.

Shortcodes vs. Gutenberg Blocks

One of the main benefits of using a Gutenberg block is that you no longer need to create shortcodes manually. As a result, the blocks have made it more accessible, and you will have fewer errors using them.

Plugins and themes are using blocks more today, and over time, you'll start to notice fewer shortcodes but more blocks — it offers a better UX (user experience) for the user.

You can add blocks for almost every instance where you usually use a shortcode. For example, you can add a block to display an image, video, slider, header area, hello bar, footer bar, etc.

The choice of blocks is growing by the day. You can use the built-in blocks already installed or add to the collection by using other blocks from third-party plugins.

Some of the best block plugins on the market are:

  • Generate Blocks — An additional block editor designed by Tom Usborne, the owner of Generate Press theme
  • Ultimate Blocks — Another block plugin adding unique blocks
  • Kadence Blocks — Kadence Blocks add more blocks to the default options on WordPress
  • Atomic Blocks — This block plugin can add more layouts, buttons, and other features.
  • The Ultimate Addons Plugin — The Astra theme developers designed this plugin

A lot of plugins are also adding blocks for you to use now; the popular ones include:

  • Yoast SEO
  • WP Forms
  • Optin Monster
  • Gravity Forms
  • And many more

How Do I Create a Custom Shortcode in WordPress?

To create your custom shortcode in WordPress, you must know about writing PHP. You don't need to be an expert, but a basic understanding is required.

The shortcode API makes it easier to create your shortcode, but it's still challenging for many people.

You need to create the shortcode function code, add it to your functions.php, and register the code with WordPress.

The video below shows you in more detail how to create your custom shortcode in WordPress.

Pros & Cons Of Using WordPress Shortcodes

There are pros and cons to using shortcodes in general, so let's take a closer look at the positives and negatives of using them.

Pros

  • You get a convenient and fast method to add dynamic content to your web pages.
  • Add intelligent design features to your blog with one short word.
  • Shortcodes work well with most themes.
  • You don't need to be an expert to use shortcodes.
  • WordPress has built-in default shortcodes ready to use.
  • They are great for plugins.
  • You have access to a growing library of shortcodes, including blocks.

Cons

  • It can become tricky to create your custom shortcode without a plugin.
  • One mistake will return an error.
  • Shortcodes can cause HTML conflicts.
  • Adding multiple shortcodes can slow your website server down.

Final Thoughts on How To Add Shortcode in WordPress

You now know how to add the shortcode in WordPress — you can add them manually or by using a plugin or Gutenberg blocks (and we can also show you some ways to rollback WordPress plugins).

All of the methods are easy to do. Besides creating a custom shortcode yourself, you shouldn't have any problems adding them.

WordPress gravitation towards blocks isn't going away, which is why so many themes and plugins are using blocks instead of having you add the shortcodes manually.

Adding them anywhere on your website is simple, and although shortcodes still have their uses, using them or adding them in a block is getting easier all the time.

Try all the methods mentioned in this article, and stick to the one that you find easiest. They all work well enough and take a matter of minutes to complete.

And in case you're interested, we also made a guide to help you know how to add a button in WordPress.

Posted in

Wordpress
<a class="txt-link" href="https://www.nichepursuits.com/author/colinshaun77icloud-com/">Colin Linnett</a>

By Colin Linnett

Colin Linnett is a seasoned copywriter and certified content marketer who helps entrepreneurs and bloggers by creating engaging content to woo their readers.

He spends most of his time writing blog posts, emails, and researching the latest marketing trends online.

Want to learn step-by-step how I built my Niche Site Empire up to a full-time income?

 

Yes! I Love to Learn

Learn How I Built My Niche Site Empire to a Full-time Income

  • How to Pick the Right Keywords at the START, and avoid the losers
  • How to Scale and Outsource 90% of the Work, Allowing Your Empire to GROW Without You
  • How to Build a Site That Gets REAL TRAFFIC FROM GOOGLE (every. single. day.)
  • Subscribe to the Niche Pursuits Newsletter delivered with value 3X per week

 

    My top recommendations

     

    How 7 Niche Site Owners Are Using Link Whisper To Grow Their Sites

    By Dan Morris

    Surfer SEO Review: Is It the Best All-In-One On Page SEO Solution?

    By Eric Burns

    RankIQ review.

    RankIQ Review: Is This AI SEO Toolset Worth Your Time and Money?

    By Amy Derungs

    jasper ai review.

    Jasper AI Review (Jarvis AI): Is It Still The Best AI Writing Assistant?

    By Dan Morris

    Content Pit Review: Is it Possible to Find Fast, Inexpensive, and High Quality Content?

    By Brady Cargle

    Want to learn step-by-step how I built my Niche Site Empire up to a full-time income?

     

    Yes! I Love to Learn

    Latest articles

     

    Podcasts

    Is Google’s Search Generative Experience (AI) any Better Than Normal Search? Plus Side Projects and Weird Niche Sites…

    By Will James

    Success Stories

    How Mahy Elamin Left Her Pharmacy Career to Build a 6 Figure/Year Food Blog

    By Samara Kamenecka

    CHATGPT FOR CUSTOMER SUPPORT.

    Artificial Intelligence

    ChatGPT for Customer Support: 7 Innovative Ways to Delight Your Customers

    By Rachel Dennis

    A woman writing a research paper

    Artificial Intelligence

    7 Powerful Ways You Can Use ChatGPT for Research

    By Rachel Dennis

    longshot AI review.

    Artificial Intelligence

    Longshot AI Review: Is It The Best Fact-Checking AI Writer?

    By Emily Brookes

    Success Stories

    How Joan Torres Makes $5k+ Blogging & Touring Off-The-Beaten-Path Destinations

    By Samara Kamenecka

    View All Articles

    Ready to find your niche?

    I would love to learn about…

     

    Subscribe

    Join Over 67,000 People Like You!

    Learn how to build a business online

     

    • We will never spam or sell your information.
    • This field is for validation purposes and should be left unchanged.

    • Privacy Policy
    • Terms of Use
    • Cookie Policy

    © 2023 Niche Pursuits

    • Earnings Disclaimer
    • Amazon FBA
    • Crafted by Fhoke

    Niche Pursuits is a participant in the Amazon Services LLC Associates Program, an affiliate advertising program designed to provide a means for us to earn fees by linking to Amazon.com and affiliated sites.