Skip to main content

WordPress Patterns

Drag saved WordPress Patterns directly into Beaver Builder layouts and keep them in sync with the source content.

Usage​

WordPress Patterns (formerly Reusable Blocks) are saved blocks created in the WordPress block editor. Beaver Builder reads every published wp_block post and surfaces each one as its own draggable item in the Content Panel, so existing patterns can be dropped into a row, column, or layout without leaving the builder.

When the underlying pattern is edited in WordPress, every Beaver Builder layout that uses it reflects the change. This makes WordPress Patterns useful for content that needs to be authored once and reused, such as shared callouts, banners, footers, and marketing blocks.

note

Beaver Builder does not add a single "WordPress Pattern" module to the Content Panel. Instead, each saved pattern is registered individually under the WordPress Patterns subgroup using its post title.

Add a WordPress Pattern to a layout​

  1. Launch Beaver Builder on your page or post.
  2. Open the Content Panel and select the WordPress Patterns subgroup.
  3. Drag the pattern you want to use into your layout.
  4. Click Done and save your changes.
note

The WordPress Patterns subgroup appears in the Content Panel only after at least one pattern has been created and saved in the WordPress block editor. If no patterns exist yet, the subgroup is not registered.

Settings​

A WordPress Pattern module has two settings on its General tab. The pattern is preselected when you drag it in, so most of the time you only need to open the settings to change how shortcodes inside the pattern are handled.

WordPress Pattern

Selects which saved pattern this module displays. The dropdown lists every published pattern by title. It is set automatically when you drag a pattern in from the Content Panel, and you can switch to a different pattern here without replacing the module.

Render Shortcodes (default: No (Recommended))

Controls whether shortcodes inside this pattern's content are run when the layout renders.

By default, Beaver Builder does not run shortcodes found inside a WordPress Pattern. Patterns can include third-party blocks whose output is not fully trusted, so any shortcode tags in that output are neutralized and printed as plain text instead of executed.

Choose Yes only when you know this specific pattern needs to run a shortcode and you trust everything it renders. The setting applies to this one module instance. Other WordPress Pattern modules on the site keep the default behavior.

note

The Render Shortcodes setting requires Beaver Builder 2.11.1 or later.

When to turn on Render Shortcodes​

The main case is a WooCommerce block checkout that falls back to the classic checkout shortcode.

WooCommerce's block-based checkout has sub-flows, such as order-pay and order-received pages, that render through the classic [woocommerce_checkout] shortcode rather than through blocks. If your checkout page is built from a WordPress Pattern that contains the checkout block, those sub-flows produce a shortcode in the pattern's output. With the default setting that shortcode is neutralized and the customer sees the raw shortcode text instead of the checkout form.

To fix this, open the settings for the pattern module on your checkout page and set Render Shortcodes to Yes. Leave every other pattern module at the default.

danger

Turning on Render Shortcodes runs every shortcode the pattern outputs, including any added by third-party blocks inside it. Only enable it for patterns whose content you control and trust.

How patterns stay in sync​

Beaver Builder renders the selected pattern's saved block markup at the position where it is dropped, and re-reads the source wp_block post each time the layout renders. Editing the pattern in Appearance > Editor > Patterns (or Pages > Patterns depending on the WordPress version) updates every layout that references it, with no need to re-open the layout in Beaver Builder.

Patterns are listed in the Content Panel ordered by menu order, then alphabetically by title. New or renamed patterns appear automatically the next time the builder is opened.

Manage patterns​

Patterns are managed in the WordPress block editor, not in Beaver Builder. To create, rename, or delete a pattern, use the standard WordPress workflow for the wp_block post type. Beaver Builder picks up the changes the next time the Content Panel is loaded.