📝 Fix the Block Editor Showing an Unsupported Block Error for a Reusable Block Imported From a Different Site’s Export File
A reusable block’s markup carries an HTML comment naming the exact block type and, for many blocks, a JSON attributes blob tied to a plugin or theme that provided it on the original site. Importing that content onto a site missing that same plugin leaves the comment pointing at a block type the editor has never registered, so Gutenberg renders it as “unsupported block” instead of silently converting it.
🔎 The Problem
Reusable block markup inside the exported WXR file:
<!-- wp:acme-plugin/pricing-table {"columns":3} -->
...
<!-- /wp:acme-plugin/pricing-table -->
Target site's installed plugins: Acme Plugin NOT present
Block Editor after import:
'This block contains unexpected or invalid content.'
Options offered: Resolve, Convert to HTML, Convert to
Classic Block
Choosing 'Convert to HTML' keeps the pricing table's
visible markup but permanently loses the block's own
editable controls, since there's no registered block
left to interpret the JSON attributes.
✅ Fix: Match the Plugin Before You Trust the Import
- Install and activate the exact plugin (or theme) that registered the block type on the source site before importing, so the editor has something to parse the block comment against.
- If the plugin is unavailable, open the problem block’s ‘Resolve’ option and inspect the raw HTML it rendered – most pricing tables, accordions, and similar blocks still display correctly as static markup even unresolved.
- For content you plan to reuse across sites going forward, prefer core blocks (Columns, Table, Group) over third-party blocks specifically because they need no matching plugin on the receiving site.
🚨 Why This Is Dangerous
- Choosing ‘Convert to Classic Block’ to make the error go away converts the entire block to raw HTML permanently – there’s no button to turn it back into the original structured block afterward.
An unsupported block isn’t corrupted content – it’s a block type the new site was never introduced to.


