How to export and import Gutenberg blocks

February 6, 2019
5 min read
export and import Gutenberg blocks

With the introduction of Gutenberg in WordPress 5, building beautiful sites is all about putting different blocks at the right place. As the Gutenberg blocks are robust and can be styled to create web pages of your choice, they can also be used on other websites. Yes, the Gutenberg editor has the default system to export and import blocks.

So, using a styled block to a different website is possible. You just need to export the blocks and import them to the site you want. It’s quite easy and just a couple of steps to go. In this article, today, we will show you how to export and import Gutenberg blocks to a different site.

NB: If the blocks are made using a plugin then the target site requires to have that plugin installed to make those blocks work. While using blocks on different themes, the block design may vary on the basis of where the CSS is being applied from.

How to export and import Gutenberg blocks

Whether you are a developer or not, you can export Gutenberg blocks and use them on other themes/sites. There are plenty of interesting features in Gutenberg editor like word to WordPress, block navigation, drag & drop, content structure, drop cap, reusable blocks and more. The system of exporting and importing blocks is just one of the mechanism that can take blocks away from where they are created and be used on other sites.

You can only export Gutenberg blocks when you have used a block and saved that to Reusables. Without that there’s nothing to export.

Step 1. Add blocks to Reusables

Before you start thinking about exporting your blocks, take a block, customize and then save that to Reusables. After you are done with styling your block, just click on the three dots on the Toolbar then click on Add to Reusables Blocks in the dropdown.

export and import Gutenberg blocks

The system requires you to give the to be saved block a name at the top of the block. Type a name then click on Save on your right.

Step 2. Go to reusable block manager

Once you have styled and saved a block, click on the three dots on the top right toolbar to access and manage all saved blocks in Reusables.

export and import Gutenberg blocks

Step 3. Export Gutenberg blocks as JSON

Block exporting option is not shown until you hover your cursor on a block name. While hovering over a block name, the options like Edit, Trash, and Export as JSON appear at the bottom of each saved block.

export and import Gutenberg blocks

Step 4. Import the JSON file to the target site

You have been working on the site where you created the blocks so far. Now you need to go to the target site and access the Manage All Reusable Blocks area.

export and import Gutenberg blocks

Click on Import from JSON at the top, choose the JSON file and hit the Import button finally.

export and import Gutenberg blocks

Now, reload the page and you will see the imported block there.

export and import Gutenberg blocks

Step 5. Access the imported block in the Gutenberg editor

To access imported blocks in the Gutenberg editor, try just like the way you reuse a saved block.

export and import Gutenberg blocks

Click on Add Block then go to the Reusables and find the imported blocks in the same names. You can also preview the blocks by hovering on their names.

Gutenberg brings many of such cool features that introduced a completely new way of creating websites on WordPress. As the days go by, people will be used to with the mechanism and enjoy building their favorite sites on this friendly block editor.

As block exporting option lies hidden and only appear when hovered. People can face difficulty finding them for the first time. This is why we’ve come up with the idea to show how to export and import Gutenberg blocks in a detailed guideline. Hope, you enjoyed it.

Need a completely Gutenberg compatible theme for blog and magazine sites? Get GutenWP for free, and build your site on WordPress’ new block editor.