Convert to Blocks transforms classic editor content to blocks on-the-fly.
Convert to Blocks is a WordPress plugin that transforms classic editor content to blocks on-the-fly. After installing Gutenberg or upgrading to WordPress 5.0+, your content will be displayed in “Classic Editor Blocks”. While these blocks are completely functional and will display fine on the frontend of your website, they do not empower editors to fully make use of the block editing experience. In order to do so, your classic editor posts need to be converted to blocks. This plugin does that for you “on the fly”. When an editor goes to edit a classic post, the content will be parsed into blocks. When the editor saves the post, the new structure will be saved into the database. This strategy reduces risk as you are only altering database values for content that needs to be changed.
Note that Inner Blocks Transforms is only supported with the Gutenberg Plugin 10.9.0+.
Screenshots
Bulk migration using the wp convert-to-blocks start
WP-CLI command that converts posts iteratively in the browser without requireing any manual input.
FAQ
How Do I Know It’s Working?
Find a classic editor in the post, try to navigate away from the page. You will get an error saying your changes will be discarded. This is because Convert to Blocks converted your content to blocks on the fly and those changes will be saved when you update the post.
Will Convert to Blocks Handle My Custom Blocks?
By default it will not.
Will Convert to Blocks Handle Nested Blocks?
Nested / Inner Block support does not work with Gutenberg bundled with WordPress Core <=5.7.2. This feature needs the Gutenberg Plugin >=10.9.0.
ChangeLog
1.2.2 – 2023-10-16
1.2.1 – 2023-07-26
1.2.0 – 2023-06-27
Note that this release bumps the WordPress minimum version from 5.7 to 6.1 and the PHP minimum version from 7.4 to 8.0.
- Added: Settings UI for managing supported post types (props @akshitsethi, @dinhtungdu, @Sidsector9, @jayedul, @dsawardekar, @terrance-orletsky-d7, @ouun via #66, #104, #112, #114).
- Added: Filter hook
convert_to_blocks_update_posts_query_params
to modify WP_Query
parameters to query posts that need to be migrated (props @kmgalanakis, @Sidsector9, @sanketio via #113).
- Added: Cypress end-to-end tests (props @barneyjeffries, @jeffpaul, @iamdharmesh, @Sidsector9, @vikrampm1 via #106).
- Changed: Bump PHP minimum supported version from 7.4 to 8.0 (props @barneyjeffries, @jeffpaul, @iamdharmesh, @Sidsector9, @vikrampm1 via #106).
- Changed: Bump WordPress minimum supported version from 5.7 to 6.1 (props @barneyjeffries, @jeffpaul, @iamdharmesh, @Sidsector9, @vikrampm1 via #106).
- Changed: Bump WordPress “tested up to” version 6.2 (props @Sidsector9 via #115).
- Changed: Updated the Dependency Review GitHub Action (props @jeffpaul via #109).
- Changed: WordPress.org Deploy action updated to use Node 16 (props @dkotter via #116).
1.1.1 – 2023-01-05
Note that this version bumps the minimum PHP version from 7.0 to 7.4 and the minimum WordPress version from 5.4 to 5.7.
- Added: Bulk migration demo to readme (props @jeffpaul, @dsawardekar via #79).
- Added: Release build GitHub Action to build a release zip used for testing (props @dkotter via #98).
- Changed: Bump WordPress minimum version from 5.4 to 5.7 and PHP minimum version from 7.0 to 7.4 (props @zamanq, @jeffpaul, @faisal-alvi, @mehul0810 via #80).
- Changed: Bump WordPress “tested up to” version to 6.1 props @peterwilsoncc, @faisal-alvi, @cadic via #88, #91).
- Removed:
is-svg
as it is no longer used after updating ancestor dependency postcss-svgo
(props @dependabot via #85).
- Fixed: WP-CLI helptext that is causing an unknown parameter error (props @dsawardekar, @jeffpaul, @norcross via #78).
- Security: Bump
socket.io-parser
from 3.2.0 to 4.2.1 and browser-sync
from 2.26.7 to 2.27.10 (props @dependabot via #81).
- Security: Bump
minimatch
from 3.0.4 to 3.1.2 (props @dependabot via #82).
- Security: Bump
nth-check
from 1.0.2 to 2.1.1 and cssnano
from 4.1.10 to 5.1.14 (props @dependabot via #84).
- Security: Bump
postcss-svgo
from 4.0.2 to 4.0.3 (props @dependabot via #85).
- Security: Bump
minimist
from 1.2.0 to 1.2.7 and mkdirp
from 0.5.1 to 0.5.6 (props @dependabot via #86).
- Security: Bump
loader-utils
from 1.2.3 to 1.4.2 and webpack-cli
from 3.3.10 to 3.3.12 (props @dependabot via #89).
- Security: Bump
glob-parent
from 5.1.0 to 5.1.2 and watchpack
from 1.6.0 to 1.7.5 (props @dependabot via #90).
- Security: Bump
kind-of
from 6.0.2 to 6.0.3 (props @dependabot via #93).
- Security: Bump
serialize-javascript
from 2.1.2 to 4.0.0 and terser-webpack-plugin
from 1.4.3 to 1.4.5 (props @dependabot via #94).
- Security: Bump
engine.io
from 6.2.0 to 6.2.1 (props @dependabot via #95).
- Security: Bump
decode-uri-component
from 0.2.0 to 0.2.2 (props @dependabot via #97).
1.1.0 – 2022-07-27
- Added: Support for bulk migrating Classic Editor items to the Block Editor, utilizing WP-CLI (props @dsawardekar, @jeffpaul, @gthayer, @faisal-alvi via #70).
- Added: Dependency security scanning (props @jeffpaul, @Sidsector9 via #64).
- Fixed: Added polyfill to fix PHPUnit tests (props @cadic, @iamdharmesh via #69).
- Changed: Bump WordPress version “tested up to” 6.0 (props @mohitwp, @jeffpaul, @cadic, @iamdharmesh via #59, #67).
- Security: Bump
path-parse
from 1.0.6 to 1.0.7 (props @dependabot via #55).
- Security: Bump
ajv
from 6.10.0 to 6.12.6 (props @dependabot via #60).
- Security: Bump
tar
from 4.4.8 to 4.4.19 (props @dependabot via #61).
- Security: Bump
terser
from 4.6.0 to 4.8.1 (props @dependabot via #74).
1.0.2 – 2021-07-12
- Changed: Bump WordPress version “tested up to” 5.8 (props @psorensen, @BBerg10up, @jeffpaul).
- Changed: Documentation updates (props @hashimwarren).
- Fixed: Transform Classic Editor blocks nested inside other blocks recursively (props @dsawardekar, @MadtownLems, @dinhtungdu, @jeffpaul).
- Fixed: Add Editor column to all supported post types (props @dinhtungdu, @scarne).
- Fixed: Display current editor for hierarchical posts (props @kreppar).
- Security: Bump
elliptic
from 6.5.3 to 6.5.4 (props @dependabot).
- Security: Bump
y18n
from 3.2.1 to 3.2.2 (@dependabot](https://github.com/apps/dependabot)).
- Security: Bump
ssri
from 6.0.1 to 6.0.2 (props @dependabot).
- Security: Bump
lodash
from 4.17.20 to 4.17.21 (props @dependabot).
- Security: Bump
hosted-git-info
from 2.7.1 to 2.8.9 (props @dependabot).
- Security: Bump
browserslist
from 4.8.3 to 4.16.5 (props @dependabot).
- Security: Bump
postcss
from 7.0.14 to 7.0.36 (props @dependabot).
- Security: Bump
color-string
from 1.5.3 to 1.5.5 (props @dependabot).
1.0.1 – 2021-02-08
1.0.0 – 2020-09-23
- Initial release of Convert to Blocks.