Block Validator finds posts with broken core blocks, the ones the editor flags with “This block contains unexpected or invalid content.” Scan a whole post type at once and get a list of what needs fixing. It never changes your content.
Before you start
- WordPress 5.8 or later
- PHP 7.0 or later
- An administrator account (the screen needs the
manage_optionscapability)
Install
- In your dashboard, go to Plugins → Add New Plugin.
- Click Upload Plugin and choose the plugin zip file.
- Click Install Now, then Activate.
How to use
Scan a post type for broken blocks
- Go to Tools → Block Validator.
- Choose a post type from the Post Type dropdown.
- Click Scan Posts. You’ll see “Fetching posts…” and then “Scanning post X of Y…” with a progress bar. Click Cancel at any time to stop.
- When the scan finishes, you’ll see “Found X post(s) with broken blocks.” and a list of those posts. If everything’s fine, you’ll see “No broken blocks found. All posts look good!”
Fix the posts it finds
- Next to a post in the results, click Edit Post. It opens in a new tab. (View Post opens the post on your site.)
- In the editor, find the block marked as invalid and use its Attempt recovery option.
- Update the post. Run the scan again to confirm it’s cleared.
What the scan checks
- Core blocks only (
core/…), including core blocks nested inside other blocks. Blocks from other plugins are skipped. - Post types that are public and available in the REST API.
- In your browser: posts are checked with the same block parser the editor uses, so results match what you’d see by opening each post. Other plugins’ block editor scripts are loaded on the screen too, so their block filters are in place before the check runs.
Developer reference
Coming soon: the hooks, filters and functions you can use with this plugin from your theme or a code snippet.
FAQs
Will scanning change my posts?
No. Block Validator only reads post content. To fix a broken block, open the post in the editor.
Who can use it?
Users who can manage site options. That’s administrators by default.
Does it check drafts?
Not yet. Scans cover published posts only.
Does it work on large sites?
Posts are fetched 100 at a time, one page after another, and then checked one by one in your browser. Keep the tab open until the scan finishes.