This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

ACF Beautiful Flexible


To use ACF Beautiful Flexible, simply activate the plugin to improve the ACF flexible UI. By default, it uses random images, but the idea is to customize them by adding your own.

Image convention

  • The size of image should be 366×150 or bigger 732×300.
  • They should be named based on the flexible key (push_2_light) with no underscores but dashes (push-2-light.[extension]).
  • The following extensions will be resolved in that order: .jpg, .jpeg, .png and .gif.

Where images should be situated

They should more likely be situated into your theme wp-content\themes\my-theme\assets\acf-beautiful-flexible\. But if you have a child-theme and added images into it, these will overwrite those from parent-theme.
The following directories will be solved according to order: plugin’s folder, child theme’s folder, theme’s folder.

Also note that you can filter this path to gather all your images into a same folder :
add_filter( ‘acf_beautiful_flexible.images_path’, $path );

Finally, you could filter all images like this :
add_filter( ‘acf_beautiful_flexible.images’, $images );

About ACF Beautiful Flexible

I, Maxime Culea, have created this plugin which I only maintain. I do not guarantee some free support. Also, thank others listed in the credits.

Consider reporting an issue and be patient.
Any code suggestions? I am on GitHub as well!


  • Show how ACF Beautiful Flexible improve the ACF’s layouts UI.


This plugin works only if the ACF Pro plugin is installed and activated.



  1. Download and install using the built-in WordPress plugin installer.
  2. Site activate in the \”Plugins\” area of the admin.
  3. Then add your awesome layouts images.


16 di Novembar dal 2022
For those of us that like to use ACF’s flexible content fields as a page builder, this is awesome. Thanks for making this!
Read all 1 review

Contributors & Developers

“ACF Beautiful Flexible” is open source software. The following people have contributed to this plugin.



1.0.4 – 2 Sept 2022

  • Fix escaping.

1.0.4 – 31 Aug 2022

  • Fix warnings for php 8.1.

1.0.3 – 05 Mai 2022

  • Publish on WordPress directory

1.0.1 – 30 April 2022

  • Compatibility with latest versions of ACF and WordPress.
  • Look for nested fields into repeaters and flexibles.


  • FIX #10: fix warning
  • Update readme with new requirements.
  • FEATURE #11: add more filetype.
  • FIX #10: fix warning.
  • FIX #8: breaking changes with ACF 5.7.0 by adding new JS.
  • Refactor way requirements are loaded by adding dedicated class.
  • #6: fix title display.
  • First version of the plugin.
  • Dynamically get flexible layouts.
  • Finish readme.
  • Add screenshot.
  • Add composer.json.
  • Init plugin.