Classic to Gutenberg WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA
Batch migration from classic editor content to Gutenberg blocks
Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/apermo/classic-to-gutenberg/archive/refs/heads/main.zipOn Packagist as apermo/classic-to-gutenberg:
composer require apermo/classic-to-gutenbergBatch migration of WordPress classic editor content to Gutenberg blocks.
Requirements
- PHP 8.2+
- WordPress 6.2+
- Composer
Installation
This plugin uses Composer for autoloading. You must run composer install before activating:
composer installIf dependencies are missing, the plugin displays an admin notice and does not load.
Usage
WP-CLI
# Show how many classic posts need conversion
wp classic-to-gutenberg status
# Preview conversion without saving
wp classic-to-gutenberg convert --dry-run
# Convert all classic posts
wp classic-to-gutenberg convert
# Convert specific post types
wp classic-to-gutenberg convert --post-type=post,page
# Detect unparseable content before converting
wp classic-to-gutenberg detect
wp classic-to-gutenberg detect --format=csv
# Rollback a converted post
wp classic-to-gutenberg rollback 42Admin Row Actions
On the Posts/Pages list screen, classic posts (without block markup) show two additional row actions:
- Convert to Blocks — converts the post content and saves immediately
- Preview Blocks — shows a preview of the converted block markup without saving
Supported Conversions
| Classic HTML | Gutenberg Block |
|---|---|
<p> |
core/paragraph |
<h1>–<h6> |
core/heading |
<ul>, <ol> |
core/list with core/list-item |
<blockquote> |
core/quote with inner core/paragraph |
<table> |
core/table (requires <thead> + <tbody>) |
<img> |
core/image (standalone, linked, or in <figure>) |
<pre> |
core/preformatted |
<hr> |
core/separator |
`|core/more` |
|
`|core/nextpage` |
|
[caption] |
core/image with caption |
[gallery] |
core/gallery with inner core/image |
| Other shortcodes | core/shortcode |
| Unrecognized HTML | core/html (fallback) |
Hooks
Filters
classic_to_gutenberg_converters— register custom block convertersclassic_to_gutenberg_pre_convert— filter content before conversionclassic_to_gutenberg_post_convert— filter content after conversionclassic_to_gutenberg_finder_args— filter post finder query argumentsclassic_to_gutenberg_shortcode_handlers— extend shortcode handler registry
Actions
classic_to_gutenberg_post_converted— fired after each post conversionclassic_to_gutenberg_post_rolled_back— fired after rollbackclassic_to_gutenberg_batch_started— fired before batch conversionclassic_to_gutenberg_batch_completed— fired after batch conversion
Development
composer cs # Run PHPCS
composer cs:fix # Fix PHPCS violations
composer analyse # Run PHPStan
composer test # Run all tests
composer test:unit # Run unit tests only
composer test:integration # Run integration tests onlyLocal WordPress Environment
ddev start && ddev orchestrateGit Hooks
Enable the pre-commit hook (PHPCS + PHPStan on staged files):
git config core.hooksPath .githooksContributing
Contributions are welcome! See CONTRIBUTING.md for guidelines.
Acknowledgements
Development of this plugin is supported by
License
Releases
6 releases.
These releases are tags only. The author does not attach a packaged zip, so there are no download counts to report.