Blocks

Blocks » Reusable Block

With reusable blocks, you can save a block (or a group of blocks) to use later in any post or page on your site. If you’re repeatedly adding the same content to the same block or group of blocks, the reusable blocks will save you a lot of time.

Table of Contents

Video Tutorial

↑ Table of Contents ↑

Create a Reusable Block

You can turn any individual block or group of blocks into a reusable block. As an example, let’s say you have a Paragraph block that you often fill with the same text and place at the end of your posts. To avoid rewriting the same content each time, you can make this content into a reusable block by following these steps:

  1. Select the block you’ll want to reuse.
  2. Click on the three dots that appear in the toolbar.
  3. Click on Add to Reusable blocks.
  4. Give it a name.
  5. Click Publish and then Save.
A gif showing the steps to create a reusable block, by selecting a block, clicking the three dots in the toolbar, and selecting "Add to Reusable blocks"
Add a reusable block

After you add a reusable block, you can identify it by its name in the following four places in the editor:

Page editor showing four locations to find the Reusable Block title, from the document Outline at the top, the block toolbar, the breadcrumbs toolbar at the very bottom of the editor, and in the sidebar settings on the right when the block is selected.
Locating the Reusable block in the editor, by its name (click to enlarge the image).

↑ Table of Contents ↑

Group Multiple Blocks into a Reusable Block

A reusable block doesn’t need to be just one block. It can be a group of blocks! In the following example, we’ll create a reusable block out of two paragraph blocks.

A gif showing that you can select multiple blocks, then click the three dots in the block toolbar and choose "Add to reusable blocks" to add a new Reusable block.
Drag your cursor to select multiple blocks or hold SHIFT and select the blocks you’d like to select.
Choosing the Correct Block

When making a block reusable, make sure that you’re selecting the block that groups all the features you want. There are blocks like the Layout Grid block, the Columns block, the Cover block, the Form block, the Payments blocks, and others that consist of grouped blocks already.

For example, if you want to add a Payments block as reusable, make sure to select the whole Payments block and not just the button block inside. In any block, you will find an icon on the top left of the toolbar that lets you select the parent block:

Screenshot of the Payments block with the parent block selector button highlighted.

In this specific example, when the Payments block is selected, you can actually verify this on your sidebar. Once you are in the correct block, you can use the option to make it reusable.

Screenshot of the Payments block on a page, with the toolbar menu selected to show the "Add to Reusable Blocks" option highlighted.

Learn more about selecting blocks.

↑ Table of Contents ↑

Add Reusable Blocks to Your Content

To add a reusable block that you have already created, click on the + Block Inserter icon and select the Reusable tab. Click the block to add it to the post or page.

In the block picker, the Reusable blocks is the tab on the right, next to Blocks and Patterns.

↑ Table of Contents ↑

Edit a Reusable Block

⚠️

When you edit a reusable block, the change will be reflected in all the places where that reusable block was used.

If you wish to update a reusable block on a specific page or post only, you can use the Convert to Regular Blocks option below.

If you’d like to edit a reusable block in all the places on your site, add the reusable block and edit it by adding more paragraphs or other types of blocks. When you’re done with the changes, click the Publish button and then the Save button.

A gif showing that you can edit a reusable block directly, then hit Publish on the top right. It will show confirmations that you are editing the Reusable block before you hit Save.

↑ Table of Contents ↑

Convert to Regular Blocks

After inserting a reusable block, you can select Convert to regular blocks if you wish to make any changes to the block on that page or post only.

A gif showing that you can click on a Reusable block's title, then click the double-block icon to Convert to regular blocks.
Convert to regular blocks

↑ Table of Contents ↑

Restore a Previous Revision

As you make changes to reusable blocks, previous versions of the block are saved in case you need to revert to an earlier version. Follow these steps to access a reusable block’s revisions:

  1. Visit the editor by editing any page or post of your site.
  2. In the top right corner of the screen, click the ellipses (three dots) icon.
  3. Select Manage Reusable blocks. Here, you will see a list of all your reusable blocks.
  4. Click on the title of any reusable block.
  5. Click the ⚙️ icon to bring up the reusable block settings, if they are not already shown.
  6. Under the Reusable block tab, click the Revisions, as shown on the right.

If “Revisions” doesn’t appear, it means that there are no saved revisions.

Clicking Revisions will show you all previously saved versions of the reusable block. Similar to revisions for pages and posts, you’ll be able to load an older version of the reusable block here if you wish.

The Reusable block module in the right sidebar of the editor. Revisions is highlighted in orange.

↑ Table of Contents ↑

Export a Reusable Block

If you have a reusable block on one site that you wish to move to another site, here’s how to export and import the block as a JSON file:

These instructions are referring to the WP Admin interface. To view this interface, click the View tab in the upper right corner and select Classic view.

  1. Visit the editor by editing any page or post of your site.
  2. In the top right corner of the screen, click the ellipses (three dots) icon.
  3. Select Manage Reusable blocks. Here, you will see a list of all your reusable blocks.
  4. Hover your mouse over any reusable block and click Export as JSON.

This will save a file to your computer. You may then import the same file by clicking on Import from JSON at the top of the reusable block management screen:

The Import from JSON button is shown on the reusable blocks screen.

Not quite what you're looking for?

Get Help