The following information is sourced from WordPress.org and was last synced on Wednesday 20th of September 2023 am30 02:52:33 AM.


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-contentthemesmy-themeassetsacf-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!


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.


No FAQs available at this time.


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.

Keep up to date with all things ACF!

Subscribe to our newsletter or follow @awesomeacf on Twitter!