Display an isolated Block Editor field on any admin page or on the front-end.
To display this field in the WP Admin, the Classic Editor must be enabled. This is a limitation of the native WP Gutenberg logic, which doesn’t allow to initialize a Block Editor inside Gutenberg itself at the moment.
The Classic Editor can be enabled using the builtin ACF Extended Classic Editor module, or with the Field Group “Hide on screen: Block Editor” setting. It is also possible to use a third party plugin, such as Classic Editor or Disable Gutenberg.
Setting name | Description |
Height | Define editor min/max height |
Autoresize | Height will be based on the editor content |
Top Bar | Show the menu bar on top of the editor |
Top Bar Tools | Display specific tools: Inserter, Selector, Undo, Contents, Navigation, Inspector and Editor |
Fixed Toolbar | Fix the toolbar on top of the editor |
Allow Code Editing | Display Code Editing |
Allow Lock | Allow blocks to be locked |
Allow File Upload | Allow users to upload files |
Allow File Library | Allow users to use the Media Library |
Allowed Blocks | Define specific blocks that can be used |
$block_editor = get_field('block_editor');
/**
* '<!-- wp:paragraph -->
* <p>Lorem ipsum dolor sit amet</p>
* <!-- /wp:paragraph -->'
*/
The Block Editor field is only compatible with blocks registered in JavaScript. It cannot be used with server-side blocks at the moment (ie. ACF Block Types). You can find a list of compatible core blocks and their description on the Gutenberg documentation here. Here is the list:
core/archives | core/audio | core/block | core/button |
core/buttons | core/calendar | core/categories | core/code |
core/column | core/columns | core/cover | core/embed |
core/file | core/freeform | core/gallery | core/group |
core/heading | core/html | core/image | core/latest-comments |
core/latest-posts | core/list | core/media-text | core/missing |
core/more | core/nextpage | core/paragraph | core/preformatted |
core/pullquote | core/quote | core/rss | core/search |
core/separator | core/shortcode | core/social-link | core/social-links |
core/spacer | core/subhead | core/table | core/tag-cloud |
core/text-columns | core/verse | core/video |