Use shortcodes in your layouts

You can insert Beaver Builder layouts as shortcodes into any text or text editor field, just like you do for any other WordPress shortcodes.

Basics:

  • WordPress shortcodes are macros that can create markup dynamically. For an introduction to WordPress shortcodes, see the WordPress Codex. Shortcodes can be recognized as a bit of code that lives between square brackets, such as [fl_builder_insert_layout id="123"].
  • When you update the source content, the shortcode content is automatically updated.
  • You can use shortcodes in the WordPress editor or in Beaver Builder module settings fields that accept text, such as the Heading field of the Heading module.

This article has the following sections:

Why use Beaver Builder shortcode?

The two most common uses for Beaver Builder shortcode are:

  • Inserting Beaver Builder module into other Beaver Builder modules where normally only text can occur, as the following examples show.
  • Inserting a section of Beaver Builder layout, such as a saved row, into a standard WordPress content area.
    For example, you could insert a SubScribe Form module into the middle of a post that is edited with the WordPress editor.

Here's an example where the shortcode for a Photo module was inserted into a feature field in a Pricing module.

The screenshot shows a Pricing Table module in which the first feature in the first feature in the first column contains text ("Your logo or custom text printed on apparel") a <br> tag to put the photo on the next line, and the shortcode for the saved Photo module.

Here are a couple of other examples of how you can use shortcodes:

  • Add a button to a cell in a Pricing Table module.
  • Embed a contact form from Beaver Builder or another plugin into a tab in a Tabs module.

Tip: If you have Beaver Themer, it can sometimes be used more efficiently than Beaver Builder shortcodes. See advanced examples of shortcodes and Themer alternatives below.

What Beaver Builder content can be turned into shortcodes?

You can create shortcodes for any Beaver Builder content that has an ID or a slug:

  • Posts, pages, or custom post types with Beaver Builder layouts
  • Saved rows, columns, or modules
  • Saved layout templates

Tips:

  • If you use the Beaver Builder Theme, there's a special [fl_year] shortcode, which you can use to insert the current date both into both Beaver Builder layouts and into text areas of the theme, such as the top bar and footer. For more information, see the article on the Beaver Builder Theme date shortcode.
  • With the Pro and Agency versions of Beaver Builder, you can use Beaver Builder shortcodes anywhere on a multisite installation. See the Shortcodes Reference in the Related Articles.

Create a Beaver Builder shortcode

Prerequisite: If you plan to use a row, module, column, or layout template in your shortcode, it must be saved first so it has its own ID and slug. See the article about saving rows, columns, and modules or the article about saving layout templates.

To create Beaver Builder shortcode:

  1. Get the ID or slug of the saved item.
    See this article for instructions.
    Note: The ID of a WordPress object is always a number. The slug is more usually a text string.
  2. Create the shortcode.
    Use one of the following formats, depending on whether it's the slug or the ID:
    [fl_builder_insert_layout slug="my-post-slug"]
    [fl_builder_insert_layout id="123"]
    See the Shortcodes reference in the Related Articles below for more advanced options.

Use this shortcode anywhere described in the following section.

Where to insert shortcodes

Most plugins that let you create content, such as gallery, slider, or form plugins, will often give you shortcode. You can insert Beaver Builder shortcodes or any other shortcodes into a Beaver Builder module or the standard WordPress editor.

In a Beaver Builder module, insert the shortcode into any text field. Here are some examples of text fields in Beaver Builder modules:

  • HTML module
  • Text editor module
  • Heading field of any module, such as the Heading or Callout module
  • Label field of a Tabs module
  • Text editor area in any module, such as the Icon module

Tips:

  • If the shortcode you add to a Beaver Builder module isn't rendered properly, try putting the shortcode into an HTML module.
  • See the Related Articles for why there can be a performance hit with the use of too many Beaver Builder shortcodes.

Add Beaver Builder shortcode to a WordPress text widget

By default, you cannot add any WordPress shortcode to WordPress text widgets. You can add this ability by adding the following code to the functions.php file in your child theme.

You can then add your shortcode to a WordPress text widget.

Tip: Beaver Themer can often replace the need for WordPress widgets since you can create layouts in areas of the page normally controlled by the theme. See the next section for some examples.

More examples of Beaver Builder shortcodes – and Beaver Themer alternatives

Here are some examples of how the Beaver Builder community have used Beaver Builder shortcodes. Note that some of these ideas require PHP coding or CSS to make them work. But also, many of these ideas are much more easily implemented in Beaver Themer, as described in the list here.

  • Create a row or module, save it, and embed the shortcode into Post content that doesn't use Beaver Builder.
    – You can use Beaver Themer to create Parts that can appear in any of the following locations on your post or page:
  • Use the shortcode in the text option in the top bar and footer layout in Beaver Builder Theme. For example, create two columns of links to fill one of the footer columns in Beaver Builder Theme.
    – In Beaver Themer, you can create Header and Footer layouts that include the top bar and footer areas and style them like you would any other Beaver Themer layout. Use field connections from the modules to link to information that can dynamically change. For example, you could display a different telephone number, date, or any other information by setting up a field connection to a custom field, which contains page-specific information. Or set up a field connection to the Tagline that appears in Customizer and the Settings tab in WordPress, so if you change your site's tagline it changes everywhere.
  • Use saved modules (such as a Subscribe Form module) as shortcodes in widgets in areas such as sidebars and footers.
    – Widgets are used to insert content in parts of the page outside of the WordPress content area, such as in widget columns above the footer if allowed by your theme. With Beaver Themer you can create layouts in areas of the page that function outside the content area. For example, in a Footer-type Themer layout, you can create Beaver Builder layouts for areas that used to require widgets. For Singular-type or Archive-type Themer layouts, you can create a sidebar with a Beaver Builder layout that includes both modules and WordPress widgets. This gives you a lot more flexibility in layout and styling than widgets do.
  • Create a custom area for clients to send feedback and watch video tutorials in the WordPress admin area.