Several of our readers have asked how to convert old WordPress post content into the new Gutenberg (block) format in WordPress.
After you update to any version above WordPress 5.0, your older post and page content will show up inside a Classic block in the new WordPress content editor.
To convert the content into individual blocks, you would need to edit each post and page separately. If you have dozens or hundreds of posts, then this can take a lot of time. Thankfully, thereβs a bulk convert option.
In this article, we will show you how to bulk convert classic blocks to individual Gutenberg blocks in WordPress.
If youβd prefer written instructions, just keep reading.
Understanding the βClassicβ Block
If you installed WordPress before version 5.0 came out, the posts and pages you created used the old or Classic editor.
When you upgrade WordPress to version 5.0 or later, all your old posts and pages still need to be editable. This means that WordPress automatically places the content for those posts and pages inside a single βClassicβ block:
This makes sure that your old posts and pages are still editable, and they look the same on the front-end of your website even if you donβt convert the content into individual blocks.
However, if you want you can convert them from a single classic block into the new multi-block format used by the WordPress block editor.
The Classic block contains all the post content, such as images, embeds, text, and more. You can go to any of the old posts on your site to see how the Classic block looks.
If you select the block by clicking on it, you can see the block type. This appears just above the block in the top left-hand corner and also in the Block settings on the right-hand side.
You can edit the content in the Classic block. Most users, though, will want to update their old posts to the new block format for ease of editing.
We covered this process in detail in our article on how to update your old WordPress posts with the Gutenberg block editor, but letβs quickly recap.
To convert an individual Classic block into new Gutenberg blocks, you can click the βMore Optionsβ button (three dots in a vertical line), and then click βConvert to Blocksβ.
Your post will then be converted into separate blocks. As you can see, the text and images have been separated here. The text is in the new βParagraphβ block.
This process is quick and straightforward for a single post. However, WordPress doesnβt have a built-in way to do it automatically for every post.
If you want to switch a lot of posts to the new Gutenberg block format at once, then youβll need a bulk converter plugin.
Bulk Convert Classic Block into Gutenberg Blocks
First, you need to install and activate the Bulk Block Converter plugin. For more details, see our step by step guide on how to install a WordPress plugin.
Upon activation, go to Tools Β» Block Conversion in your WordPress dashboard. Youβll see the following screen:
Tip: Make sure you create a complete WordPress backup of your site before using the bulk block converter. You cannot undo the conversion once itβs taken place.
To start, click the βScan Contentβ button and the converter will find all your content thatβs ready for conversion.
Note: Posts that use a mix of Classic blocks and other blocks wonβt be picked up by the converter.
If you want to convert all the content on your site at once, simply click the large βBulk Convert Allβ button at the top of the screen.
Youβll see a warning like this. Go ahead and click βOKβ to continue.
If you donβt want to convert everything at once, thatβs fine too. You can filter the list by βPost Typeβ (posts or pages). You can also switch to the βPublishedβ or βDraftsβ lists to see only that set of posts.
You can select everything on your list by clicking the checkbox to the left of βTitleβ. Weβll filter our list to show pages, not posts, and then select all of them:
You can even select individual posts and pages by clicking on the checkbox to the left of their title.
Note that if you use this method, you wonβt see the warning before the conversion takes place. Once each piece of content is converted, youβll see βConvertedβ listed next to it in the table.
Important Tip About Shortcodes
One snag you might run into is that the Bulk Block Conversion tool doesnβt convert shortcodes. Itβll create a shortcode block for you, but youβll need to put the shortcode itself back in manually.
If youβre using shortcodes, then make sure you note them down before running the bulk converter. Otherwise, it could take a while to figure out which shortcodes you need to put back and where to place them.
We hope this article helped you learn how to bulk convert classic blocks to Gutenberg in WordPress. You may also want to see our comparison of the best WordPress drag & drop page builders and the best WordPress contact form plugins.
If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.