WordPress 7.1 renders the post editor canvas inside an iframe on every
post, unconditionally. ACF PRO cannot initialise its field forms inside
that iframe, so from 7.1 every ACF block is forced into preview mode with
its fields squeezed into the right-hand sidebar — the familiar inline
“edit mode” disappears.
WordPress 7.1 still ships the old non-iframed canvas rendering path; core
just stopped using it. This plugin serves a copy of the wp-editor script
bundle with the single flag that controls this flipped
(shouldIframe: true becomes false), which restores the pre-7.1
editing experience: ACF block fields render inline in the main canvas,
full width, with working WYSIWYG, media pickers and repeaters.
Safety properties
wp core verify-checksums passes).post.php / post-new.php receive the patched bundle.SCRIPT_DEBUG is enabled.Block requirements
Inline edit mode is an ACF Blocks v2 behaviour. ACF PRO 6.8+ defaults
block.json blocks to v3 on WordPress 7.1+, which removes edit mode by
design (iframe or not) — every block becomes a preview with an
“Edit Block” modal. This plugin therefore pins the default back to v2
via ACF’s acf/blocks/default_block_version filter. Your blocks should:
"blockVersion": 3 explicitly in block.json (an explicit"acf": { "mode": "edit" } (and ideally "supports": { "mode": false })Blocks saved while stuck in preview mode carry "mode":"preview" in their
saved markup, which overrides the block default. For blocks whose mode
toggle is hidden ("supports": { "mode": false }) the plugin resets that
to the block’s configured mode when the post is parsed in the editor, and
the content self-heals on the next save. Blocks that allow toggling keep
the saved choice. To clean everything in one go instead:
wp search-replace '"mode":"preview"' '"mode":"edit"' wp_posts --include-columns=post_content
Updates
Updates are delivered through the WordPress.org plugin directory like any
other plugin. Updates do not apply when the file is run as a must-use
plugin.
When to remove this plugin
This is a compatibility shim, not a permanent architecture. Remove it once
ACF PRO supports field editing inside the iframed canvas — check the ACF
changelog before major WordPress upgrades. After any WordPress core
update, open a post in the editor and confirm blocks still show inline
forms; if the fail-safe has kicked in they will show previews again, and
the plugin needs a new patch pattern for that WordPress version.
Disabling programmatically
add_filter( 'tts_inline_canvas_enabled', '__return_false' );