Skip to content

Known Issues

Edi Amin edited this page Sep 3, 2025 · 2 revisions

Body Classes Preview in Block Editor

The body classes feature requires specific conditions to work properly in the block editor preview:

Requirements:

  • All registered blocks must have Block API version 3 or higher
  • WordPress 6.3+ with iframe-based block editor, or the latest Gutenberg plugin installed

Limitations:

  • If blocks use older API versions, the iframe won't be generated and real-time preview won't work
  • Preview may not work immediately when switching between Visual and Code editor modes

Workaround:

  • Update your theme/plugin blocks to use Block API version 3+
  • Install and activate the latest Gutenberg plugin for better compatibility
  • Body classes will still be applied to the frontend even if preview doesn't work in the editor

For more technical details, see this Gutenberg issue and the editor changelog.

Clone this wiki locally