22 Jan

ACF PRO v5.1.7 update

This update introduces a new tab field style, improves performance, and fixes various bugs


  • Tab field: Added new placement setting for top aligned / left aligned
  • Image field: Fixed selection bug when attachment popup also contains an image field
  • File field: Fixed selection bug when attachment popup also contains a file field
  • WYSIWYG field: Prevented full-height feature until WP provide compatibility for multiple editors
  • Core: Fixed many field bugs in WP media grid popup
  • Core: Added new friendly field wrap classes: acf-field-{$type} acf-field-{$key}
  • Core: JS speed improvements due to new field wrap classes
  • Core: Added new filter for removing compatibility https://www.advancedcustomfields.com/resources/acfcompatibility/
  • Core: Minor fixes and improvements
  • Language: Updated German translation – thanks to Thomas Meyer


One of the main features of this update is the new friendly field wrap classes. These classes are easier to work with and help speed up the ACF javascript. To ensure no websites hit any JS or CSS issues, the previous classes still remain. If you, like me, want to remove any bloat, checkout the new filter available to remove compatibility for the old classes.

add_filter('acf/compatibility/field_wrapper_class', '__return_false');

If possible, please also consider searching your theme for the strings field_type- and field_key- and change both to acf-field-.

Minor fixed and improvements

There are quite a few in this version, so here’s a detail list:

    • Added margin above tab fields when editing a field group
    • Changed markup / CSS / JS on the edit field group page
    • Fixed image field multiple select not working within a ‘block layout’ repeater field
    • Fixed incorrect return_url redirect within the acf_form / acf_form_head functions when site is in a sub folder
    • Changed various functions to validate ‘WordPress Theme Check’
    • Added missing text domains to various strings