What are WordPress Shortcodes?
Reading Time: 4 minutes 
If you have a WordPress website, you’ve probably used, heard about, or even unknowingly used shortcodes. You may have noticed the shortcode widget in Gutenberg or in plugins. But what the heck are shortcodes — exactly?
Shortcodes are text snippets enclosed in square brackets that tell WordPress to do certain things when they appear on a page or post. You add a specified shortcode, and WordPress runs the background code.
Before shortcodes, you had to write PHP code to create your desired layout or functionality. Now, with the help of talented developers, themes and plugins do all that for you. Then, you insert the provided shortcode and whallah.
If you have a WordPress website, you have probably used the gallery shortcode at some point. It looks something like this:
This is the basic shortcode that WordPress inserts into a post when you use the Gallery block to display a gallery of photos on a page or post that you uploaded into WordPress. In addition, you can add attributes such as size, columns, id, type, include, exclude, and more to further customize the gallery’s display.
For example:
The above shortcode tells WordPress to display gallery three in two columns in ascending order.
A Little Shortcode History
Introduced on March 29, 2008 in WordPress 2.5, the Shortcode API, is a simple set of functions for creating macro codes for use in post content. It enables plugin and theme developers to create special kinds of content (e.g. forms, content generators) that users can attach to certain pages by adding the corresponding shortcode into the page text.
Common uses of shortcodes include embedding contact forms. Once your form is set up to your liking in the plugin’s control panel, insert the provided shortcode into a shortcode block on the desired page, and wallah.
Many form plugins now include their own form widgets, eliminating the need for manual shortcode input. You insert the form plugin widget into your page, select the form in the plugin’s widget, and the form is inserted and displayed as you configured it.
Before WordPress existed, my Project Inquiry form would have required minimal HTML and a server-side CGI script to be configured. Now, with just a couple of brackets and characters, anyone can add formatting to their site that would otherwise be unavailable to non-developers.
Rare is the theme or plugin developer who isn’t using the WordPress Shortcode API to offer shortcodes that make formatting or using their products much easier.
Can you create your own shortcodes on the fly?
The Gutenberg Editor, introduced with WordPress 5.0, includes blocks that handle shortcodes. When converting content to Gutenberg, the “Convert to Blocks” option converts existing shortcodes into shortcode blocks.
However, WordPress’s built-in set of shortcodes is still available for those using the Classic Editor plugin, so you can delay switching to the default Gutenberg Editor. But it’s time to get into the present, as the Classic Editor plugin is not long for this world.
TAKE THE PLUNGE: Click the Convert to Blocks button (top left of your screen) to begin getting used to and working with blocks. It won’t hurt—I promise. You can do it in a post/page at a time.
Shortcode use and integration vary by theme, developer, and plugin. When investigating new themes, you may find a menu tab within the theme demo titled “Shortcodes” to see what built-in custom shortcodes are available to insert where you want.
An example of a theme that relies on shortcodes is Divi by Elegant Themes. ET uses shortcodes extensively in their Divi All-In-One WordPress Theme & Visual Page Builder. While this approach makes visually designing a website uber-easy for non-developers, if you choose to discontinue using Divi, you’ll have to remove all those shortcodes, which can be a complicated process.
[More about “Builders” here…]
Example Functionality of Shortcodes
Other examples of how shortcodes are used and integrated via themes and plugins:
There is a varied selection of Shortcode-related plugins for you to choose from and use on your site in the WordPress plugin repository. With shortcodes, you can customize your site even further without needing to know any code.
It’s sort of like magic.
At your service,
