Title: Cosmo Block Edit Mode for ACF
Author: bakhods
Published: <strong>August 29, 2026</strong>
Last modified: August 29, 2026

---

Search plugins

![](https://s.w.org/plugins/geopattern-icon/cosmo-block-edit-mode-for-acf.svg)

# Cosmo Block Edit Mode for ACF

 By [bakhods](https://profiles.wordpress.org/bakhods/)

[Download](https://downloads.wordpress.org/plugin/cosmo-block-edit-mode-for-acf.1.0.3.zip)

 * [Details](https://wordpress.org/plugins/cosmo-block-edit-mode-for-acf/#description)
 * [Reviews](https://wordpress.org/plugins/cosmo-block-edit-mode-for-acf/#reviews)
 *  [Installation](https://wordpress.org/plugins/cosmo-block-edit-mode-for-acf/#installation)
 * [Development](https://wordpress.org/plugins/cosmo-block-edit-mode-for-acf/#developers)

 [Support](https://wordpress.org/support/plugin/cosmo-block-edit-mode-for-acf/)

## Description

Since the post editor canvas is always rendered inside an iframe, Advanced Custom
Fields forces every ACF block into preview mode: the toolbar toggle disappears and
the field form is pushed into the sidebar. There is no filter or setting to turn
that behaviour off.

This plugin restores the previous experience. The toolbar toggle comes back and 
the fields are edited in place, inside the block, exactly where the content is.

Cosmo Block Edit Mode for ACF is an independent, unofficial plugin. “ACF” and “Advanced
Custom Fields” are trademarks of WP Engine; this plugin is not affiliated with, 
endorsed by, or sponsored by WP Engine or the Advanced Custom Fields team, and the
name refers to that plugin solely to describe what this one works with.

#### How it works

The plugin builds a patched copy of the ACF blocks script on the fly. The only change
is one internal “is the editor iframed?” check, which is made to always return false.
The copy is stored in `wp-content/uploads/cosmo-block-edit-mode-for-acf/` and its
file name is derived from the ACF version and the source file, so it is rebuilt 
automatically after every ACF update.

If a future ACF release rewrites that part of the code, the plugin silently serves
the untouched original and shows a warning in the admin area. Your site never breaks–
it simply falls back to the current ACF behaviour.

Some extra styling and a small companion script are loaded inside the canvas iframe,
because the iframe does not inherit the wp-admin stylesheets that ACF fields depend
on. These also fix everything that breaks once a field lives in a different document
than the scripts driving it: select2 dropdowns, tooltip placement, and the WYSIWYG
field – TinyMCE, Quicktags, the Visual/Text tabs and the Add Media button.

#### Requirements

This plugin requires **ACF PRO**, a commercial plugin sold separately by WP Engine
and not distributed through WordPress.org. Blocks are a PRO-only feature. With ACF
PRO inactive, this plugin does nothing at all.

This plugin is not affiliated with, endorsed by, or sponsored by WP Engine or the
Advanced Custom Fields team.

#### Developers

Turn the patch off without deactivating the plugin:

    ```
    add_filter( 'cosmo/block_edit_mode_for_acf/enabled', '__return_false' );
    ```

## Installation

 1. Install and activate ACF PRO.
 2. Upload the plugin through **Plugins – Add New – Upload Plugin**, or install it 
    from the plugin directory.
 3. Activate **Cosmo Block Edit Mode for ACF**.
 4. Open a post containing an ACF block – the mode toggle is back in the block toolbar.

## FAQ

### Does this modify the ACF plugin files?

No. The ACF installation is left untouched. A patched copy of one script is generated
in the uploads folder and served instead of the original, only inside the admin 
area.

### What happens when ACF updates?

The patched copy is keyed to the ACF version and rebuilt automatically. If the code
it patches has changed too much to recognise, the original script is served and 
an admin notice asks you to update this plugin.

### Does it work with the free version of ACF?

No. ACF blocks are a PRO-only feature, so there is nothing to patch in the free 
version.

### What is left behind when I delete the plugin?

Nothing. Deleting the plugin removes the generated cache folder in `wp-content/uploads/`
and the internal flag it uses.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Cosmo Block Edit Mode for ACF” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ bakhods ](https://profiles.wordpress.org/bakhods/)

[Translate “Cosmo Block Edit Mode for ACF” into your language.](https://translate.wordpress.org/projects/wp-plugins/cosmo-block-edit-mode-for-acf)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/cosmo-block-edit-mode-for-acf/),
check out the [SVN repository](https://plugins.svn.wordpress.org/cosmo-block-edit-mode-for-acf/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/cosmo-block-edit-mode-for-acf/)
by [RSS](https://plugins.trac.wordpress.org/log/cosmo-block-edit-mode-for-acf/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.2

 * Fixed post_object, taxonomy, user, page_link and select fields inside the canvas
   hanging on “Searching…” and never loading a single option. ACF focuses the search
   box of an open dropdown by looking it up in the parent document; for a dropdown
   that lives in the canvas the lookup comes back empty, and the exception it raises
   aborts Select2 before it gets to request the results.
 * Added the Select2 stylesheet to the canvas, so such a field no longer renders
   as a bare drop-down list next to an unstyled search box.

#### 1.0.1

 * Fixed the WYSIWYG field never initialising inside the canvas. TinyMCE and Quicktags
   look their textarea up by id in the parent document, where it no longer is: Quicktags
   threw “Cannot read properties of undefined (reading ‘buttons’)” and TinyMCE silently
   attached to nothing, leaving the field as a plain textarea.
 * Fixed the Visual/Text tabs and the Add Media button of a WYSIWYG field doing 
   nothing – WordPress delegates both from the parent document, which never sees
   a click made inside the canvas.
 * Added the TinyMCE skin and the editor button styles to the canvas, so the editor
   toolbars are no longer unstyled.

#### 1.0.0

 * Initial release.

## Meta

 *  Version **1.0.3**
 *  Last updated **2 days ago**
 *  Active installations **1,000+**
 *  WordPress version ** 6.8 or higher **
 *  Tested up to **7.1**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [block-editor](https://wordpress.org/plugins/tags/block-editor/)[blocks](https://wordpress.org/plugins/tags/blocks/)
   [custom fields](https://wordpress.org/plugins/tags/custom-fields/)[editor](https://wordpress.org/plugins/tags/editor/)
   [inline editing](https://wordpress.org/plugins/tags/inline-editing/)
 *  [Advanced View](https://wordpress.org/plugins/cosmo-block-edit-mode-for-acf/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/cosmo-block-edit-mode-for-acf/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/cosmo-block-edit-mode-for-acf/reviews/)

## Contributors

 *   [ bakhods ](https://profiles.wordpress.org/bakhods/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/cosmo-block-edit-mode-for-acf/)