Changelog

Proudly improving Advanced Custom Fields since 1.0.0

6.2.7

Release Date 27th February 2024

  • Security Fix - the_field now escapes potentially unsafe HTML as notified since ACF 6.2.5. For full information, please read the release blog post
  • Security Fix - Field and Layout names are now enforced to alphanumeric characters, resolving a potential XSS issue
  • Security Fix - The default render template for select2 fields no longer allows HTML to be rendered resolving a potential XSS issue
  • Security Enhancement - A acf/shortcode/prevent_access filter is now available to limit what data the ACF shortcode is allowed to access
  • Security Enhancement - i18n translated strings are now escaped on output
  • Enhancement - ACF now universally uses WordPress file system functions rather than native PHP functions

6.2.6.1

Release Date 7th February 2024

  • Fix - Fatal JS error no longer occurs when editing fields in the classic editor when Yoast or other plugins which load block editor components are installed
  • Fix - Using $escape_html on get functions for array returning field types no longer produces an Array to string conversion error

6.2.6

Release Date 6th February 2024

  • Enhancement - The get_field() and other get_ functions now support an escape_html parameter which return an HTML safe field value
  • Enhancement - The URL field will be now escaped with esc_url rather than wp_kses_post when returning an HTML safe value
  • Fix - ACF fields will now correctly save into the WordPress created revision resolving issues with previews of drafts on WordPress 6.4 or newer
  • Fix - Multisite subsites will now correctly be activated by the main site where the ACF PRO license allows, hiding the updates page on those subsites
  • Fix - Field types in which the required property would have no effect (such as the tab, or accordion) will no longer show the option
  • Fix - Duplicating a field group now maintains the current page of field groups being displayed
  • Fix - Fields in ACF Blocks in edit mode in hybrid themes will now use ACF’s styling, rather than some attributes being overridden by the theme
  • Fix - Text in some admin notices will no longer overlap the dismiss button
  • Fix - The word link is now prohibited from being used as a CPT name to avoid a WordPress core conflict
  • Fix - Flexible content layouts can no longer be duplicated over their maximum count limit
  • Fix - All ACF notifications shown outside of ACF’s admin screens are now prefixed with the plugin name
  • Fix - ACF no longer checks if a polyfill is needed for <PHP7 and the polyfill has been removed

6.2.5

Release Date 16th January 2024

  • Security Fix - The ACF shortcode will now run all output through wp_kses, escaping unsafe HTML. This may be a breaking change to your site but is required for security, a message will be shown in WordPress admin if you are affected. Please see the blog post for this release for more information. Thanks to Francesco Carlucci via Wordfence for the responsible disclosure
  • Security - ACF now warns via an admin message, when upcoming changes to the_field and the_sub_field may require theme changes to your site to avoid stripping unsafe HTML. Please see the blog post for this release for more information
  • Security - Users may opt in to automatically escaping unsafe HTML via a new filter acf/the_field/escape_html_optin when using the_field and the_sub_field before this becomes default in an upcoming ACF release.

6.2.4

Release Date 28th November 2023

  • Fix - Custom Post Types labels now match the WordPress 6.4 behavior for "Add New" labels
  • Fix - When exporting both post types and taxonomies as PHP, taxonomies will now appear before post types, matching the order ACF registers them. This resolves issues where taxonomy slugs will not work in post type permalinks
  • Fix - Advanced Settings for Taxonomies, Post Types or Options Pages now display with the correct top padding when toggled on
  • Fix - When a parent option page is set to "Redirect to Child Page", the child page will now correctly show it's parent setting
  • Fix - When activated as a must-use plugin, the ACF PRO "Updates" page is now visible. Use the existing show_updates setting to hide
  • Fix - When activated as a must-use plugin, ACF PRO licenses defined in code will now correctly activate sites
  • Fix - When show_updates is set or filtered to false, ACF PRO will now automatically still activate defined licenses
  • i18n - Maintenance and internal upstream messages from the ACF PRO activation server are now translatable

6.2.3

Release Date 15th November 2023

  • View Release Post
  • New - An ACF Blocks specific JSON schema for block.json is now available on GitHub
  • New - Flexible Content fields now show the layout name in the layout's header bar and supports click-to-copy
  • New - Duplicating Flexible Content layouts now appends "Copy" to their name and label, matching the behavior of field group duplication
  • Enhancement - ACF PRO will now automatically attempt license reactivation when the site URL changes, e.g. after a site migration. This resolves issues where updates may fail
  • Enhancement - Presentation setting for "High" placement of the Field Group made clear that it's not supported in the block editor
  • Fix - acf_format_date now ensures the date parameter is valid to prevent fatal errors if other data types are passed in
  • Fix - CPTs with a custom icon URL now display the posts icon in the location column of the field groups screen
  • Fix - The ACF JSON import form will now disable on first submit resolving an issue where you could submit the form twice
  • Fix - The "Add Row" button in the Flexible Content field now displays correctly when using nested layouts
  • Fix - Warning and Error notices no longer flicker on ACF admin pages load
  • i18n - ACF PRO license activation success and error messages are now translatable

6.2.2

Release Date 25th October 2023

  • Enhancement - ACF Blocks which have not been initialized by the editor will now render correctly
  • Enhancement - Added a new acf/filesize filter to allow third party media plugins to bypass ACF calling filesize() on attachments with uncached file sizes, which may result in a remote download if offloaded
  • Enhancement - ACF PRO license status and subscription expiry dates are now displayed on the “Updates” page
  • Fix - Product pages for WooCommerce version 8.2 or newer now correctly support field group location rules
  • Fix - Relationship field items can now be removed on mobile devices
  • Fix - Color picker fields no longer autocomplete immediately after typing 3 valid hex characters
  • Fix - Field settings no longer appear misaligned when the viewport is something other than 100%
  • Fix - Select fields without an aria-label no longer throw a warning
  • Fix - CPTs and Taxonomies with a custom text domain now export correctly when using PHP export

6.2.1.1

Release Date 8th September 2023

  • Fix - Editing a field group no longer generates an error when UI options pages are disabled

6.2.1

Release Date 7th September 2023

  • New - Options Pages created in the admin UI can now be assigned as child pages for any top-level menu item
  • New - Added a "Title Placeholder" setting to ACF Post Types which filters the "Add title" text when editing posts
  • Enhancement - ACF PRO will now warn when it can’t update due to PHP version incompatibilities
  • Enhancement - ACF PRO will now work correctly with WordPress automatic updates
  • Enhancement - The internal ACF Blocks template attribute parser function parseNodeAttr can now be shortcut with the new acf_blocks_parse_node_attr filter.
  • Enhancement - Removed legacy code for supporting WordPress versions under 5.8
  • Fix - The "Menu Position" setting is no longer hidden for child options pages
  • Fix - The tabs for the "Advanced" settings in Post Types and Taxonomies are now rendered inside a wrapper div
  • Fix - Options pages will no longer display as a child page in the list view when set to a top level page after previously being a child
  • Fix - Conflict with Elementor CSS breaking the ACF PRO banner
  • Fix - Errors generated during the block editor’s savePost function will no longer be caught and ignored by ACF

6.2.0

Release Date 9th August 2023

  • View Release Post
  • New - ACF now requires WordPress version 5.8 or newer, and PHP 7.0 or newer. View the release post for more information
  • New - Bidirectional Relationships now supported for Relationship, Post Object, User and Taxonomy fields. View the release post for more information
  • New - Options Pages can now be registered and managed by the admin UI in ACF PRO
  • New - Link to the product feedback board added to the plugin footer
  • Enhancement - ACF JSON now supports multiple save locations (props Freddy Leitner)
  • Enhancement - ACF Post Types and Taxonomies can now be duplicated
  • Enhancement - The filename for JSON files can now be customized with the acf/json/save_file_name filter
  • Fix - REST updates of fields with choices containing integer or mixed keys now behave correctly
  • Fix - Using the block_type_metadata_settings PHP filter to add usesContext values no longer breaks ACF blocks
  • Fix - Notice to import post types/taxonomies from CPTUI no longer flashes on page load
  • Fix - Various buttons for fields in blocks now display correctly
  • Fix - The settings for the DateTime field are no longer cut off when nested in several fields in the field group editor
  • Fix - The newline added to the end of JSON files will now use PHP_EOL to detect the correct newline character with a filter acf/json/eof_newline to alter it.
  • i18n - Updated French and Portuguese translations (Thanks to pedro-mendonca and maximebj)

6.1.8

Release Date 3rd August 2023

  • Security Fix - This release resolves a stored XSS vulnerability in admin screens with ACF post type and taxonomy labels (Thanks to Satoo Nakano and Ryotaro Imamura)

6.1.7

Release Date 27th June 2023

  • New - Added new capability settings for ACF taxonomies
  • Enhancement - Added a new acf/field_group/auto_add_first_field filter which can be used to prevent new field groups from automatically adding a field
  • Enhancement - Field setting labels now have standard capitalization in the field group editor
  • Enhancement - Clone field now has a tutorial link
  • Enhancement - "Exclude From Search" CPT setting now has an improved description
  • Enhancement - The acf_get_posts() function now has acf/acf_get_posts/args and acf/acf_get_posts/results filters
  • Enhancement - Added a new acf/options_page/save action hook that gets fired during save of ACF Options Pages
  • Fix - Taxonomies are now initialized before post types, preventing some permalink issues
  • Fix - Increased the taxonomy slug maximum length to 32 characters
  • Fix - Extra tabs are no longer added to PHP exports with field settings containing multiple lines
  • Fix - ACF admin assets now load when editing profile and users for a multisite network
  • Fix - Blocks with recursive render_callback functions will no longer crash the editor
  • Fix - JSON files now end in a new line for better compatibility with code editors
  • i18n - layout(s) strings in Flexible Content fields are now translatable
  • i18n - Updated Polish translations

6.1.6

Release Date 4th May 2023

  • Security Fix - This release resolves an XSS vulnerability in ACF’s admin pages (Thanks to Rafie Muhammad for the responsible disclosure)
  • Fix - Duplicating fields in a new field group with field setting tabs disabled now behaves correctly

6.1.5

Release Date 2nd May 2023

  • Enhancement - Creating a new field group from the post-save actions for a post type or taxonomy will automatically populate the field group title
  • Enhancement - Empty values in list tables now display as a dash, rather than blank
  • Enhancement - The Generate PHP export tool for field groups now displays the code wrapped in the acf/include_fields action hook to match the recommended way of using acf_add_local_field_group, and the code is formatted correctly
  • Enhancement - Post count and Term count values in list tables now link through to the matching posts or terms
  • Enhancement - Added post-save actions to post type and taxonomies to create another
  • Enhancement - Selecting existing taxonomies when registering a Custom Post Type is now available in the Basic settings section rather than Advanced
  • Fix - Exclude From Search setting for custom post types now behaves correctly
  • Fix - Duplicating fields with sub fields no longer results in JS errors
  • Fix - Select2 field settings now render correctly when duplicating fields
  • Fix - Checkbox fields allowing custom values which use integer keys can now be updated over the REST API
  • Fix - Using the No Permalink rewrite setting for post type will no longer generate PHP warnings
  • Fix - The minimum rows not met validation message for the Repeater field type now correctly states the minimum rows are not met
  • Fix - The Range field type no longer cuts off three digit values
  • Fix - Created on and Delete Field Group now correctly only appear on the Group Settings tab of a field group
  • Fix - Padding for field settings tabs is now correct
  • i18n - Updated all PRO translation files, removing legacy free strings which are now handled through translate.wordpress.org
  • i18n - Updated PRO translations with the latest contributions from GitHub (Thanks to @MilenDalchev, @Xilonz and @wiliamjk)

6.1.4

Release Date 12th April 2023

  • Fix - ACF now detects when another plugin or theme is loading an incompatible version of Select2, and will fallback to a basic select field for the field type selection
  • Fix - Post Object, Page Link and Relationship field types now use a default post_status filter of any, matching the behavior prior to ACF 6.1. This can be edited per field in the field group admin or via the acf/fields/$field_type/query filters
  • Fix - Post Type and Taxonomy key generation now uses dashes rather than underscores
  • Fix - The "add first" text no longer appears when no search results are found for ACF field groups, post types or taxonomies

6.1.3

Release Date 5th April 2023

  • Fix - 'Create Terms' button for taxonomy fields now displays correctly
  • Fix - ACF JSON field group files which have unsupported keys (not beginning with group_) will now load as field groups
  • Fix - Renaming capabilities for post types will now set map_meta_cap to true solving an issue with assigning permissions to roles for that post type

6.1.2

Release Date 4th April 2023

  • View Release Post
  • Fix - Calls to acf_add_options_page after acf_add_local_field_group before acf/init will now behave correctly
  • i18n - All new ACF 6.1 strings are now correctly English (United States) by default

6.1.1

Release Date 3rd April 2023

  • Fix - Calls to acf_add_local_field_group before acf/init now behave correctly

6.1.0

Release Date 3rd April 2023

  • View Release Post
  • New - Register Custom Post Types and Taxonomies using ACF. View the release post for full information
  • New - A new field type selection browser providing details on each type of field. View the release post for full information.
  • New - PHP 8.1 and 8.2 support
  • Security Fix - ACF's data serialization system will now prevent classes being unserialized. This prevents a potential security issue should an attacker know a vulnerable class is available, and can write malicious data to the database.
  • Enhancement - Post Object, Page Link and Relationship fields now support filtering by post status
  • Enhancement - Checkbox fields which allow custom entries can now be filtered to set custom text for the “Add New Choice” button using the custom_choice_button_text property
  • Fix - ACF Block field edit view buttons now work correctly inside reusable blocks
  • Fix - An empty callback function in now passed to scripts to prevent JS warnings when using Google Map fields
  • Fix - Checkbox field values now support keys indexed as 0
  • Fix - Automatic deactivation of the free or PRO plugin when activating the other now displays the correct message in the admin notice
  • Fix - Empty Flexible Content fields will no longer cause an error when used in the block editor on save.
  • Fix - Admin notices now behave correctly and are closable in RTL languages

6.0.7

Release Date 18th January 2023

  • Improvement - Removed unnecessary “Layout” prefix text in the admin UI for Flexible Content field layouts
  • Fix - Dragging and dropping fields containing settings rendered as radio button groups no longer removes the selected value
  • Fix - Using the WordPress default_page_template_title filter with two parameters no longer causes a fatal error
  • Fix - Select2 inputs in the content editor are no longer receiving styles from the ACF 6 admin UI
  • Fix - acf_add_local_field_group() now works with field group titles containing non-ASCII characters
  • Fix - Flexible Content field no longer has a missing icon for the “Duplicate” button
  • Fix - Clicking the “Add Field” button in a Flexible Content layout no longer adds an invalid field if there are other Flexible Content fields in the layout
  • Fix - Edit buttons for ACF blocks now behave correctly inside reusable blocks
  • Fix - Field settings rendered as a select2 field now correctly reinitialize when changing between field types

6.0.6

Release Date 13th December 2022

  • View Release Post
  • New - Flexible Content field now has a new admin user experience when editing layouts
  • New - Tabs for field settings in the field group editor can now be disabled via a new “Field Settings Tabs” screen option or with the new acf/field_group/disable_field_settings_tabs filter
  • Improvement - General field settings tab now selected by default when a field is opened
  • Fix - Sub fields are no longer initialized by their parent, resolving performance issues when field groups contain many nested sub fields
  • Fix - Frontend forms now disable the submit button after click to prevent multiple submissions
  • Fix - Unknown field types no longer display broken HTML in the field group editor
  • Fix - Returning an empty string via the acf/blocks/no_fields_assigned_message filter will no longer result in blocks without fields assigned having an extra wrapping div
  • Fix - Sites with WPML enabled no longer experience failed ACF updates due to license errors
  • Fix - Buttons featuring icons no longer have display issues when using RTL languages

6.0.5

Release Date 18th November 2022

  • Fix - Uploading multiple files nested in a subfield no longer causes a fatal error when using basic uploader (props @JoKolov)

6.0.4

Release Date 8th November 2022

  • Improvement - JavaScript initialization performance while editing large field groups has been improved, especially in Safari
  • Improvement - Tooltips for field settings are now shown as inline instructions
  • Improvement - Saving a field group is now disabled until a field group title has been entered
  • Improvement - Additional sanitization across various internal parts of the plugin
  • Fix - Dragging and dropping a field in no longer opens the field settings in Firefox
  • Fix - Copying the field name or key to the clipboard now works as expected for new or reordered fields, and subfields
  • Fix - Saving a field group will now temporarily disable the "Save Changes" button while saving
  • Fix - Block templates that include html comments as the first DOM element no longer crash the block editor on edit
  • Fix - Block templates that include InnerBlocks on the DOM’s first level no longer trigger JS warnings
  • Fix - Block templates that render other blocks now correctly render their InnerBlocks
  • Fix - Legacy block attribute values are no longer overwritten by blank defaults of new versions
  • Fix - Paginated Repeater fields now work with non-paginated Repeaters as subfields
  • Fix - Repeater pagination is now properly disabled while inside blocks
  • Fix - REST API no longer causes a PHP warning if $_SERVER['REQUEST_METHOD'] is not defined
  • Fix - REST API now supports integer keys for the Select field
  • Fix - REST API now supports passing null to Image and File fields
  • Fix - Invalid ACF meta keys no longer cause a fatal error when retrieved with get_fields()
  • a11y - The Relationship field is now fully accessible for keyboard navigation
  • i18n - Select dropdown arrow is now aligned correctly in RTL languages
  • i18n - Radio buttons are now aligned correctly in RTL languages

6.0.3

Release Date 18th October 2022

  • Security Fix - ACF shortcode security fixes detailed here
  • Improvement - Field names and keys now copy to clipboard on click, and do not open a field
  • Fix - The field type input now has default focus when adding a new field
  • Fix - ACF no longer publishes h1, h2 or h3 CSS classes outside of the ACF admin screens
  • Fix - Conditional field settings now work correctly across different tabs
  • Fix - The field list for sub fields are now full width
  • Fix - ACF admin notices now display with correct margin
  • Fix - Admin CSS improvements when using ACF in an RTL language
  • Fix - Clone fields now have the presentation tab for setting wrapper properties when in group display mode
  • Fix - Appended labels on field settings will now be displayed in the correct place
  • Accessibility - The move field modal is now keyboard and screen reader accessible

6.0.2

Release Date 29th September 2022

  • Improvement - Field group and field rows no longer animate on hover to reveal the action links
  • Fix - Field order is now saved correctly when fields are reordered
  • Fix - WordPress notice styles outside of ACF's admin screens are no longer affected by the plugin's CSS

6.0.1

Release Date 28th September 2022

  • Improvement - ACF's header bar inside our admin pages is no longer sticky
  • Improvement - ACF's admin pages no longer use a custom font
  • Fix - Duplicating flexible content layouts now works correctly
  • Fix - ACF CSS classes no longer target translated class names for sub pages, resolving issues when using ACF in a language other than English
  • Fix - ACF no longer reactivates when using WPML with different domains per language
  • Fix - i18n - Labels for some field settings no longer break onto multiple lines in languages other than English
  • Fix - Radio field types no longer generate a warning in logs due to invalid parameter counts
  • Fix - True/False field focus states no longer apply outside ACF admin screens
  • Fix - Focus states for many field types no longer show when interacting with a mouse input
  • Fix - ACF 6’s new Tab background colors no longer apply outside ACF admin screens, increasing readability
  • Fix - User fields named “name” no longer have a different label presentation view
  • Fix - Changing field types with subfields no longer removes those fields when switching field type and back
  • Fix - Resolved a potential fatal error if a third party plugin sets the global $post_type something other than a string
  • Fix - Tooltip alignment is no longer incorrect inside subfields
  • Fix - Resolved a potential JS error when third party plugins modify the metabox sort order

6.0.0

Release Date 21st September 2022

  • New - ACF now has a new refreshed UI with improved UX for editing field groups, including a new tabbed settings layout for fields. Third party ACF extension plugin developers can read more about the optional changes they can make to support the new tabs in our release announcement post
  • New - Repeaters now have an optional "Pagination" setting which can be used to control the number of rows displayed at once. More details can be found on our Repeater field documentation
  • New - ACF Blocks now have a versioning system allowing developers to opt in to new features
  • New - ACF Blocks now support version 2, enabling block.json support, reduced wrapper markup and significant other new features. Full details and examples of this can be found in What's new with ACF Blocks in ACF 6
  • New - ACF Blocks no longer use Block IDs saved in the block comment. See What's new with ACF Blocks in ACF 6 for more information.
  • Enhancement - Bulk actions for field groups now include "Activate" and "Deactivate" options
  • Fix - ACF will no longer perform a multisite database upgrade check on every admin load once each upgrade has been performed
  • Fix - ACF Blocks preloading now works for blocks saved in edit mode
  • Fix - ACF Blocks edit forms now behave correctly if they are not visible when loaded
  • Fix - ACF Blocks now always fire render_block_preview events when a block preview is displayed or redisplayed
  • Fix - ACF Blocks with no fields now display advisory text and are selectable in the block editor. This message is filterable with the acf/blocks/no_fields_assigned_message filter, providing both the message to be displayed and the block name it's being displayed against
  • Fix - Accordions inside ACF Blocks now match the current native block styling
  • Fix - ACF Blocks which contain no fields now preload correctly
  • Fix - Changes to an ACF Block's context now trigger a re-render
  • Fix - A rare warning inside wp_post_revision_field will no longer be possible
  • Fix - The field “move” option now no longer displays for fields when only one field group exists
  • Fix - Language for field group activation state now standardized to "active" and "inactive"
  • Fix - SVGs containing foreignObject tags now correctly render in JSX rendered ACF Blocks
  • Fix - Server errors during ACF updates or version checks are now cached for 5 minutes rather than 24 hours
  • Accessibility - The new ACF UI has significantly improved accessibility for screen readers and alternative input options
  • i18n - All strings inside ACF are now translatable
  • i18n - Accented term names in taxonomy fields are no longer corrupted at output
  • i18n - ACF translations are now synced with contributions from translation.wordpress.org at each release, increasing ACF's supported languages and updating many other translations. PRO strings should still be submitted as pull requests on GitHub (Additional thanks to maximebj, emreerkan and Timothée Moulin for their contributions which are included here)

5.12.6

Release Date 4th May 2023

  • Security Fix - This release resolves an XSS vulnerability in ACF’s admin pages (Thanks to Rafie Muhammad for the responsible disclosure)

5.12.5

Release Date 4th April 2023

  • Security Fix - ACF's data serialization system will now prevent classes being unserialized. This prevents a potential security issue should an attacker know a vulnerable class is available, and can write malicious data to the database. See the 6.1.0 release post for more information

5.12.4

Release Date 18th October 2022

  • Security Fix - ACF shortcode security fixes from the ACF 6.0.3 release. See the 6.0.3 release post for more information

5.12.3

Release Date 14th July 2022

  • Security Fix - Inputs for basic file uploads are now nonced to prevent an issue which could allow arbitrary file uploads to forms with ACF fields (Thanks to James Golovich from Pritect, Inc.)

5.12.2

Release Date 6th April 2022

  • Fix - Cloned fields in custom named options pages now behave correctly
  • Fix - Default values and the acf/load_value filter are now applied if a field value load fails security validation
  • Fix - The ACF field is no longer present in REST responses if the ACF REST API setting is disabled
  • Fix - Duplicating a flexible content layout or repeater row now also replaces the field ID in for attributes

5.12.1

Release Date 23rd March 2022

  • New - REST API now supports the comment route for displaying ACF fields.
  • Fix - ACF now validates access to option page field values when accessing via field keys the same way as field names. View More
  • Fix - REST API now correctly validates fields for POST update requests
  • Fix - Fixed an issue where invalid field types caused an error during REST API requests
  • Fix - Fixed a PHP warning when duplicating an empty field group
  • Fix - Fixed a bug preventing block duplication detection changing an ACF Block’s ID if it was nested deeper than one level inside another block
  • Fix - Fixed a bug where the acf-block-preview wrapper might not appear around a block if it was saved in edit mode
  • i18n - Updated several translations from user contributions (Thanks to Dariusz Zielonka, Mikko Kekki and Alberto!)

5.12

Release Date 23rd February 2022

  • View Release Post
  • New - ACF blocks now support the new Full Site Editor included in WordPress 5.9
  • New - ACF blocks now support the WordPress Query Loop block
  • New - Added block caching system to reduce the number of AJAX calls in the block editor
  • Enhancement - Block preloading can now be disabled by using "acf_update_setting( 'preload_blocks', false );" in the "acf/init" action hook
  • Enhancement - ACF and ACF PRO will now detect if each other are active and deactivate the other plugin on plugin activation
  • Fix - Fixed an issue with the media library not working correctly in ACF Blocks in WordPress 5.9.1
  • Fix - Fixed an issue where anchors weren't working correctly in WordPress 5.9
  • Fix - Fixed an issue where the "unfiltered_html" capability wasn't being used by ACF blocks
  • Fix - Fixed an issue where it was impossible to update an ACF block inside the widget block editor
  • Fix - Fixed an issue where ACF fields might not appear in REST API calls made via internal WordPress functions
  • Fix - Warnings and PHP 8.1 deprecation notices in REST API
  • Fix - Better support for double byte characters in "acf_get_truncated()" (props @cabradb)
  • i18n - Broken link in the Croatian translation
  • i18n - Automated building of acf.pot for translators in each release

5.11.4

Release Date - 2nd December 2021

  • Fix - Fixed several Select2.js conflicts with other plugins
  • Fix - Fixed an issue where block name sanitization could change valid block names containing double hyphens
  • Fix - Fixed an issue where blocks with integer IDs could fail to load example field data

5.11.3

Release Date - 24th November 2021

  • Fix - Fixed a bug when accessing field values for options pages registered with a custom post_id

5.11.2

Release Date - 24th November 2021

  • Fix - Previously implemented data access changes for get_field() and the_field() are now limited to the ACF shortcode only. Learn more
  • Fix - get_field() and the_field() functions can once again access meta values regardless of being registered with ACF, restoring functionality that existed before 5.11
  • Fix - get_field() and the_field() functions now are only able to access site options which are ACF fields
  • Fix - UI issues for select boxes related to Yoast and WooCommerce’s select2 versions by upgrading our select2 version, and updating our CSS to support older versions
  • Fix - User fields failed to load values when using the legacy select2 v3 option
  • Fix - acf_slugify() now correctly supports special characters which solves issues with block names or field group names (during imports) containing those characters
  • Fix - PHP Notice generated while processing a field group’s postbox classes

5.11.1

Release Date - 18 November 2021

  • Enhancement - Added "acf/admin/license_key_constant_message" filter to allow changing of the "Your license key is defined in wp-config.php" message
  • Fix - Added warning for when get_field() or similar functions are called before ACF has initialized. Learn more
  • Fix - Fixed fields not appearing on user REST API endpoints if their field group location was set to a user form other than "all"
  • Fix - Fixed warning in REST API if a custom field type did not have the "show_in_rest" property
  • Fix - Fixed an error that could occur if value of WYSIWYG field was not a string

5.11

Release Date - 10 November 2021

  • View Release Post
  • New - Fields can now be viewed and updated with the WordPress REST API (props @mishterk)
  • New - License key can now be defined in code with the "ACF_PRO_LICENSE" constant
  • Enhancement - Improved error handling for expired or deactivated licenses
  • Enhancement - Improved support for various block editor features, such as block styles and padding/spacing
  • Enhancement - Added support for using WordPress "Screen Options" to hide field groups in Classic Editor
  • Enhancement - Support filters adding custom classes on date and time field inputs
  • Enhancement - Support filtering ACF shortcode attributes (with the "shortcode_atts_acf" filter)
  • Fix - Removed usages of PHP "extract()" function
  • Fix - Fixed a security issue with user field
  • Fix - Fixed a security issue with "acf_get_value()"
  • Fix - Correctly set ".acf-block-preview" wrapper when previewing a block in auto mode
  • Fix - Resolved an issue with select2 rendering for nav menu fields
  • Fix - Fixed an issue with file validation that occurred when removing a file that failed validation
  • Fix - Fixed a notice in "acf_prepare_field()"
  • Fix - Prevented an issue where setting an empty string for the return format of date and time fields would cause JS errors
  • Fix - Fix issues with conditional logic for multi-select fields (props @bhujagendra-ishaya)
  • Fix - Added support for Google Maps schema change which prevented Google Maps fields from correctly saving the city for some areas
  • Fix - Fixed an issue where removing the collapsed property of a repeater prevents viewing previously collapsed rows
  • i18n - Updated Polish Translations (props @webnatural)
  • Dev - Formatted JavaScript to WordPress code standards

5.10.2

Release Date - 31 August 2021

  • Fix - Fixed block duplication issues which created blocks with duplicate block IDs
  • Fix - Fixed an issue with ACF errors displaying in the media library outside of ACF fields
  • Fix - Changed label of "Enable Opacity?" to "Allow transparency" in the colour picker
  • Fix - Revert "style" attributes of ACF Blocks to 5.9.x behaviour for template compatibility
  • Fix - Allow safe HTML inside select2 field labels
  • Fix - Don't render the "acf-block-preview" div when preloading blocks in edit mode

5.10.1

Release Date - 26 August 2021

  • Fix - Fixed conflict with WooCommerce loading SelectWoo which is not directly compatible with Select2.

5.10

Release Date - 25 August 2021

  • View Release Post
  • Enhancement - Improved security by running all user-generated content through wp_kses() by default
  • Enhancement - New ACF Blocks features
    • Switched to v2 of the Blocks API for WordPress 5.6+
    • Block preloading now enabled by default
    • Block preloading now supports blocks set to "Edit" mode
    • Add support for full height alignment setting
  • Enhancement - Added setting to color picker field to enable an opacity slider
  • Enhancement - Allow deletion of first field group location rule if multiple rules have been added thanks to Arthur Shlain
  • Fix - Fixed vulnerability with acf_shortcode() where users with subscriber role could view arbitrary ACF data, thanks to Keitaro Yamazaki
  • Fix - Fixed vulnerability where users with subscriber role could move fields and view field groups, thanks to Keitaro Yamazaki
  • Fix - Fixed issue where fields in legacy widgets weren't saving in new widget block editor
  • Fix - Fixed issue with custom field validation in scheduled posts
  • Fix - Fixed warnings thrown by clone field if the cloned field group is empty
  • Fix - Fixed issue where Select2 search input wouldn't have focus in WordPress 5.8+
  • Fix - Fixed issue with Select2 value sorting when Yoast SEO is installed
  • Fix - Fixed deprecation warnings in block editor in WordPress 5.6+
  • i18n - Updated Swedish translation thanks to Erik Betshammar

5.9.9

Release Date - 20 July 2021

  • Fix - Fixed warning when deleting fields which don't exist
  • Fix - Fixed issues with older browsers and the blocks JavaScript
  • Fix - Fixed file size & file type validation for front end forms using the basic uploader

5.9.8

Release Date - 08 July 2021

  • Fix - Fixed bug causing multiple image fields to not validate files properly
  • Fix - Fixed bug preventing case-sensitive HTML tags from working in blocks
  • Fix - Fixed bug causing JSX-enabled blocks to improperly remove whitespace in preview
  • Fix - Fixed bug causing text fields to remove HTML entities when editing saved fields
  • Fix - Fixed deprecated jQuery notices on "Add Field Group" page

5.9.7

Release Date - 22 June 2021

  • Fix - Fixed PHP warnings logged due to incorrect parameter type for add_menu_page()/add_submenu_page()
  • Fix - Fixed bug causing WYSIWYG field to not keep line breaks
  • Fix - Fixed bug causing Email field to incorrectly invalidate emails with unicode characters
  • Fix - Fixed bug causing file type validation to fail in some cases
  • Fix - Fixed bug where newly uploaded or selected images do not contain custom preview size data

5.9.6

Release Date - 20 May 2021

  • Enhancement - Added 'position' setting compatibility for Options Page submenus.
  • Enhancement - Visually highlight "High" metabox area when dragging metaboxes.
  • Fix - Fixed compatibility issue between Block matrix alignment setting and the latest version of Gutenberg (10.6).
  • Fix - Fixed bug breaking WYSIWYG field after reordering a child block via the block's toolbar up/down buttons.
  • Fix - Added missing "readonly" and "disabled" attributes to DateTime and Time picker fields.
  • Fix - Fixed bug incorrectly validating Email field values containing special characters.
  • Fix - Fixed missing "dashicons" asset dependency from front-end forms.
  • Fix - Fixed bug causing Review JSON diff modal to appear with narrow column since WP 5.7.
  • Dev - Added label elements to Repeater, Flexible Content and Clone field's table header titles.
  • Dev - Added new ACF_EXPERIMENTAL_ESC_HTML constant. Read more

5.9.5

Release Date - 11 February 2021

  • Fix - Fixed regression preventing blocks from loading correctly within the editor in WordPress 5.5.
  • Fix - Fixed bug causing incorrect post_status properties when restoring a Field Group from trash in WordPress 5.6.
  • Fix - Fixed edge case bug where a taxonomy named "options" could interfere with saving and loading option values.
  • Fix - Fixed additional PHP 8.0 warnings.
  • i18n - Updated Finnish translation thanks to Mikko Kekki

5.9.4

Release Date - 14 January 2021

  • Enhancement - Added PHP validation for the Email field (previously relied solely on browser validation).
  • Fix - Added support for PHP 8.0 (fixed logged warnings).
  • Fix - Added support for jQuery 3.5 (fixed logged warnings).
  • Fix - Fixed bug causing WYSIWYG field to appear unresponsive within the Gutenberg editor.
  • Fix - Fixed regression preventing "blog%d" and "site%d" as valid $post_id values for custom Taxonomy terms.
  • Fix - Fixed bug causing Radio field label to select first choice.
  • Fix - Fixed bug preventing preloading blocks that contain multiple parent DOM elements.
  • i18n - Updated Japanese translation thanks to Ryo Takahashi.
  • i18n - Updated Portuguese translation thanks to Pedro Mendonça.

5.9.3

Release Date - 3 November 2020

  • Fix - Fixed bug causing Revision meta to incorrectly update the parent Post meta.
  • Fix - Fixed bug breaking "Filter by Post Type" and "Filter by Taxonomy" Field settings.

5.9.2

Release Date - 29 October 2020

  • Enhancement - Added experiment for preloading block HTML and reducing AJAX requests on page load.
  • Fix - Added boolean attribute value detection to JSX parser (fixes issue with templateLock="false").
  • Fix - Added "dateTime" attribute to JSX parser ruleset.
  • Fix - Fixed unresponsive Select2 instances after duplicating a row or layout.
  • Fix - Added missing Color Picker script translations for previous WordPress versions.
  • Fix - Fixed bug in Clone Field causing potential PHP error if cloning a Field Group that no longer exists.
  • Fix - Fixed PHP warning logged when comparing a revision that contains values for a Field that no longer exist.
  • Dev - Added $wp_block parameter to block render_callback and render_template (unavailable during AJAX preview requests).
  • Dev - Deprecated acf_get_term_post_id() function.

5.9.1

Release Date - 8 September 2020

  • Fix - Fixed guten-bug causing "Preview Post" button to publish changes.
  • Fix - Fixed guten-bug causing JS errors when editing with Elementor or Beaver Builder.
  • Fix - Fixed bug in Color Picker field causing JS error on front-end forms.
  • Fix - Fixed bug in Post Taxonomy location rule causing incomplete list of rule choices.
  • Fix - Reverted Local JSON "save to source path" enhancement due to DX feedback.
  • i18n - Updated Indonesian translations thanks to Rio Bahtiar.
  • i18n - Updated Turkish translation thanks to Emre Erkan.

5.9.0

Release Date - 17 August 2020

  • Enhancement - New Field Groups admin.
    • Added toolbar across all ACF admin pages.
    • Added new table columns: Description, Key, Location, Local JSON.
    • Added popup modal to review Local JSON changes before sync.
    • Added visual representation of where Field Groups will appear.
    • Added new help tab.
    • Simplified layout.
  • Enhancement - New ACF Blocks features.
    • Added support for Inner Blocks.
    • Added new "jsx" setting.
    • Added new "align_text" settings.
    • Added new "align_content" settings.
  • Enhancement - Added duplicate functionality for Repeater and Flexible Content fields.
  • Enhancement - Added PHP validation support for Gutenberg.
  • Enhancement - Added ability to bypass confirmation tooltips (just hold shift).
  • Enhancement - Local JSON files now save back to their loaded source path (not "save_json" setting).
  • Tweak - Replaced all custom icons with dashicons.
  • Tweak - Changed custom post status label from "Inactive" to "Disabled".
  • Tweak - Improved styling of metaboxes positioned in the block editor sidebar.
  • Fix - Improved AJAX request efficiency when editing block className or anchor attributes.
  • Fix - Fixed bug causing unresponsive WYSIWYG fields after moving a block via the up/down arrows.
  • Fix - Fixed bug causing HTML to jump between multiple instances of the same Reusable Block.
  • Fix - Fixed bug sometimes displaying validation errors when saving a draft.
  • Fix - Fixed bug breaking Image field UI when displaying a scaled portrait attachment.
  • Fix - Fixed bug in Link field incorrectly treating the "Cancel" button as "Submit".
  • Fix - Fixed bug where a sub field within a collapsed Repeater row did not grow to the full available width.
  • Fix - Ensured all archive URLs shown in the Page Link field dropdown are unique.
  • Fix - Fixed bug causing incorrect conditional logic settings on nested fields when duplicating a Field Group.
  • Fix - Fixed bug causing license activation issues with some password management browser extensions.
  • Dev - Major improvements to ACF_Location class.
  • Dev - Refactored all location classes to optimize performance.
  • Dev - Extracted core JavaScript from "acf-input.js" into a separate "acf.js" file.
  • Dev - Field Group export now shows "active" attribute as bool instead of int.
  • Dev - Added filter "acf/get_object_type" to customize WP object information such as "label" and "icon".
  • Dev - Added action "acf/admin_print_uploader_scripts" fired when printing uploader (WP media) scripts in the footer.
  • Dev - Added filters "acf/pre_load_attachment" and "acf/load_attachment" to customize attachment details.
  • Dev - Added filter "acf/admin/toolbar" to customize the admin toolbar items.
  • Dev - Added new JS actions "duplicate_fields" and "duplicate_field" fired when duplicating a row.
  • i18n - Changed Croatian locale code from "hr_HR to "hr".
  • i18n - Updated Portuguese translation thanks to Pedro Mendonça.
  • i18n - Updated French Canadian translation thanks to Bérenger Zyla.
  • i18n - Updated French translation thanks to Maxime Bernard-Jacquet.
  • i18n - Updated German translations thanks to Ralf Koller.

5.8.14

Release Date - 13 August 2020

  • Fix - Fixed bug breaking ACF Block $is_preview parameter in WordPress 5.5.
  • Fix - Fixed bug breaking seamless postbox style in WordPress 5.5.

5.8.13

Release Date - 10 August 2020

  • Tweak - Added styling compatibility for WordPress 5.5.
  • Fix - Implemented new wp_filter_content_tags() function in "acf_the_content" filter.
  • i18n - Updated Arabic translation thanks to Karim Ramadan.

5.8.12

Release Date - 10 June 2020

  • Fix - Improved string escaping in Select2 drop-downs to address XSS concerns.
  • Fix - Fixed bug causing PHP error when updating the settings of a Checkbox field.
  • Fix - Fixed bug causing WYSIWYG field to hide when toggling between Document and Block tabs within the Block editor.
  • Fix - Fixed bug incorrectly validating the length of Text and Textarea field values that contained HTML entities.

5.8.11

Release Date - 12 May 2020

  • Fix - Fixed bug in ACF Blocks where "inserter examples" and "block templates" did not load the defined "data".
  • Fix - Reverted "fix" in 5.8.9 regarding Taxonomy fields saving terms to non "post" objects.
  • Fix - Fixed bug allowing the Image field to save the value of a deleted attachment.
  • Fix - Improved Select field format_value() behaviour to correctly cast value types depending on the "multiple" setting.
  • Tweak - Changed language fallback for "zh_HK" to "zh_TW".
  • Tweak - Changed Time Picker field settings to display in a localized format via date_i18n().
  • Tweak - Improved CSS styling of menu item fields.
  • i18n - Updated Finnish translation thanks to Mikko Kekki
  • i18n - Updated French translation thanks to Maxime Bernard-Jacquet.
  • i18n - Updated Turkish translation thanks to Emre Erkan.

5.8.10

Release Date - 12 May 2020

  • See hotfix version 5.8.11 for release notes.

5.8.9

Release Date - 26 March 2020

  • Fix - Fixed bug in ACF Blocks causing default "align" property to be ignored.
  • Fix - Fixed bug allowing Taxonomy field to save terms to a non "post" object.
  • Tweak - Improved User field AJAX query performance.
  • Tweak - Improved logic that determines width of Range field input.
  • Tweak - Improved styling of ACF Blocks components.
  • Dev - Added new "acf/register_block_type_args" filter.
  • Dev - Added new generic ACF_Ajax_Query and ACF_Ajax_Query_Users classes.
  • i18n - Updated French Canadian translation thanks to Bérenger Zyla.
  • i18n - Updated Traditional Chinese translation thanks to Audi Lu.
  • i18n - Updated German translation thanks to Ralf Koller.
  • i18n - Updated Portuguese translation thanks to Pedro Mendonça.

5.8.8

Release Date - 4 March 2020

  • Fix - Fixed bug in have_rows() function causing a PHP warning when no value is found.
  • Fix - Fixed bug in Google Maps field causing marker to snap to nearest address.
  • Fix - Avoid Nav Menu items displaying twice in WordPress 5.4.
  • Tweak - Added place name data to Google Maps field value.
  • Tweak - Improved performance of PHP registered fields.
  • Dev - Added new "acf/prepare_field_group_for_import" filter.
  • i18n - Added Traditional Chinese translation thanks to Audi Lu.
  • i18n - Added Catalan translation thanks to Jordi Tarrida.
  • i18n - Updated French translation thanks to Maxime Bernard-Jacquet & Bérenger Zyla.

5.8.7

Release Date - 12 November 2019

  • New - Updated admin CSS for new WordPress 5.3 styling.
  • Fix - Fixed various issues affecting dynamic metaboxes in the block editor (requires WordPress 5.3)
  • Fix - Fixed performance issue when checking network sites for upgrades.
  • Fix - Fixed Select2 clones appearing after duplicating a Relationship field.
  • Tweak - Repeater field "Add row" icons will now hide when maximum rows are reached.
  • Tweak - Removed ACF Blocks keyword limit for later versions of Gutenberg.

5.8.6

Release Date - 24 October 2019

  • New - Added more data to Google Maps field value including place_id, street_name, country and more.
  • Fix - Fixed bug in Gallery field incorrectly displaying .pdf attachments as icons.
  • Fix - Fixed bug in Checkbox field missing "selected" class after "Toggle All".
  • Dev - Added compatibility for Attachments in the Post Taxonomy location rule.
  • Dev - Added missing return statement from acf_get_form() function.
  • Dev - Added "google_map_result" JS filter.

5.8.5

Release Date - 8 October 2019

  • New - Added new choice "Add" to the User Form location rule.
  • New - Optimized acf_form() logic when used in combination with acf_register_form().
  • Fix - Fixed bug causing incorrect field order after sync.
  • Fix - Fixed bug reverting the first field type to Text in Firefox version 69.0.1.
  • Fix - Fixed bug causing tinymce issues when changing between block modes.
  • Fix - Fixed bug preventing block registration when category does not exist.
  • Fix - Fixed bug preventing block registration when no icon is declared.
  • Dev - Added RegExp compatibility for innerBlocks.

5.8.4

Release Date - 3 September 2019

  • New - Optimized Relationship field by delaying AJAX call until UI is visible.
  • Fix - Fixed bug incorrectly escaping HTML in the Link field title.
  • Fix - Fixed bug showing Discussion and Comment metaboxes for newly imported field groups.
  • Fix - Fixed PHP warning when loading meta from Post 0.
  • Dev - Ensure Checkbox field value is an array even when empty.
  • Dev - Added new ACF_MAJOR_VERSION constant.

5.8.3

Release Date - 7 August 2019

  • Tweak - Changed Options Page location rules to show "page_title" instead of "menu_title".
  • Fix - Fixed bug causing Textarea field to incorrectly validate maxlength.
  • Fix - Fixed bug allowing Range field values outside of the min and max settings.
  • Fix - Fixed bug in block RegExp causing some blocks to miss the "acf/pre_save_block" filter.
  • Dev - Added $block_type parameter to block settings "enqueue_assets" callback.
  • i18n - Added French Canadian language thanks to Bérenger Zyla.
  • i18n - Updated French language thanks to Bérenger Zyla.

5.8.2

Release Date - 15 July 2019

  • Fix - Fixed bug where validation did not prevent new user registration.
  • Fix - Fixed bug causing some "reordered" metaboxes to not appear in the Gutenberg editor.
  • Fix - Fixed bug causing WYSIWYG field with delayed initialization to appear blank.
  • Fix - Fixed bug when editing a post and adding a new tag did not refresh metaboxes.
  • Dev - Added missing $value parameter in "acf/pre_format_value" filter.

5.8.1

Release Date - 3 June 2019

  • New - Added "Preview Size" and "Return Format" settings to the Gallery field.
  • Tweak - Improved metabox styling for Gutenberg.
  • Tweak - Changed default "Preview Size" to medium for the Image field.
  • Fix - Fixed bug in media modal causing the primary button text to disappear after editing an image.
  • Fix - Fixed bug preventing the TinyMCE Advanced plugin from adding < p > tags.
  • Fix - Fixed bug where HTML choices were not visible in conditional logic dropdown.
  • Fix - Fixed bug causing incorrect order of imported/synced flexible content sub fields.
  • i18n - Updated German translation thanks to Ralf Koller.
  • i18n - Updated Persian translation thanks to Majix.

5.8.0

Release Date - 8 May 2019

  • New - Added ACF Blocks feature for ACF PRO.
  • Fix - Fixed bug causing duplicate "save metabox" AJAX requests in the Gutenberg editor.
  • Fix - Fixed bug causing incorrect Repeater field value order in AJAX requests.
  • Dev - Added JS filter 'relationship_ajax_data' to customize Relationship field AJAX data.
  • Dev - Added $field_group parameter to 'acf/location/match_rule' filter.
  • Dev - Bumped minimum supported PHP version to 5.4.0.
  • Dev - Bumped minimum supported WP version to 4.7.0.
  • i18n - Updated German translation thanks to Ralf Koller.
  • i18n - Updated Portuguese language thanks to Pedro Mendonça.

5.7.13

Release Date - 6 March 2019

  • Fix - Fixed bug causing issues with registered fields during switch_to_blog().
  • Fix - Fixed bug preventing sub fields from being reused across multiple parents.
  • Fix - Fixed bug causing the get_sub_field() function to fail if a tab field exists with the same name as the selected field.
  • Fix - Fixed bug corrupting field settings since WP 5.1 when instructions contain < a target="" >.
  • Fix - Fixed bug in Gutenberg where custom metabox location (acf_after_title) did not show on initial page load.
  • Fix - Fixed bug causing issues when importing/syncing multiple field groups which contain a clone field.
  • Fix - Fixed bug preventing the AMP plugin preview from working.
  • Dev - Added new 'pre' filters to get, update and delete meta functions.
  • i18n - Update Turkish translation thanks to Emre Erkan.

5.7.12

Release Date - 15 February 2019

  • Fix - Added missing function register_field_group().
  • Fix - Fixed PHP 5.4 error "Can't use function return value in write context".
  • Fix - Fixed bug causing wp_options values to be slashed incorrectly.
  • Fix - Fixed bug where "sync" feature imported field groups without fields.
  • Fix - Fixed bug preventing get_field_object() working with a field key.
  • Fix - Fixed bug causing incorrect results in get_sub_field().
  • Fix - Fixed bug causing draft and preview issues with serialized values.
  • Fix - Fixed bug causing reversed field group metabox order.
  • Fix - Fixed bug causing incorrect character count when validating values.
  • Fix - Fixed bug showing incorrect choices for post_template location rule.
  • Fix - Fixed bug causing incorrect value retrieval after switch_to_blog().
  • i18n - Updated Persian translation thanks to Majix.

5.7.11

Release Date - 11 February 2019

  • New - Added support for persistent object caching.
  • Fix - Fixed PHP error in determine_locale() affecting AJAX requests.
  • Fix - Fixed bug affecting dynamic metabox check when selecting "default" page template.
  • Fix - Fixed bug where tab fields did not render correctly within a dynamic metabox.
  • Tweak - Removed language fallback from "zh_TW" to "zh_CN".
  • Dev - Refactored various core functions.
  • Dev - Added new hook variation functions acf_add_filter_variations() and acf_add_action_variations().
  • i18n - Updated Portuguese language thanks to Pedro Mendonça.
  • i18n - Updated German translation thanks to Ralf Koller.
  • i18n - Updated Swiss German translation thanks to Raphael Hüni.

5.7.10

Release Date - 16 January 2019

  • Fix - Fixed bug preventing metaboxes from saving if validation fails within Gutenberg.
  • Fix - Fixed bug causing unload prompt to show incorrectly within Gutenberg.
  • Fix - Fixed JS error when selecting taxonomy terms within Gutenberg.
  • Fix - Fixed bug causing jQuery sortable issues within other plugins.
  • Tweak - Improved loading translations by adding fallback from region to country when .mo file does not exit.
  • Tweak - Improved punctuation throughout admin notices.
  • Tweak - Improved performance and accuracy when loading a user field value.
  • Dev - Added filter 'acf/get_locale' to customize the locale used to load translations.
  • Dev - Added filter 'acf/allow_unfiltered_html' to customize if current user can save unfiltered HTML.
  • Dev - Added new data storage functions acf_register_store() and acf_get_store().
  • Dev - Moved from .less to .scss and minified all css.
  • i18n - Updated French translation thanks to Maxime Bernard-Jacquet.
  • i18n - Updated Czech translation thanks to David Rychly.

5.7.9

Release Date - 17 December 2018

  • Fix - Added custom metabox location (acf_after_title) compatibility with Gutenberg.
  • Fix - Added dynamic metabox check compatibility with Gutenberg.
  • Fix - Fixed bug causing required date picker fields to prevent form submit.
  • Fix - Fixed bug preventing multi-input values from saving correctly within media modals.
  • Fix - Fixed bug where acf_form() redirects to an incorrect URL for sub-sites.
  • Fix - Fixed bug where breaking out of a sub have_rows() loop could produce undesired results.
  • Dev - Added filter 'acf/connect_attachment_to_post' to prevent connecting attachments to posts.
  • Dev - Added JS filter 'google_map_autocomplete_args' to customize Google Maps autocomplete settings.

5.7.8

Release Date - 7 December 2018

  • Fix - Fixed vulnerability allowing author role to save unfiltered HTML values.
  • Fix - Fixed all metaboxes appearing when editing a post in WP 5.0.
  • i18n - Updated Polish translation thanks to Dariusz Zielonka.
  • i18n - Updated Czech translation thanks to Veronika Hanzlíková.
  • i18n - Update Turkish translation thanks to Emre Erkan.
  • i18n - Updated Portuguese language thanks to Pedro Mendonça.

5.7.7

Release Date - 1 October 2018

  • Fix - Fixed various plugin update issues.
  • Tweak - Added 'language' to Google Maps API url.
  • Dev - Major improvements to the acf.models.Postbox model.
  • Dev - Added JS filter 'check_screen_args'.
  • Dev - Added JS action 'check_screen_complete'.
  • Dev - Added action 'acf/options_page/submitbox_before_major_actions'.
  • Dev - Added action 'acf/options_page/submitbox_major_actions'.
  • i18n - Updated Portuguese language thanks to Pedro Mendonça

5.7.6

Release Date - 12 September 2018

  • Fix - Fixed unload prompt not working.
  • Dev - Reduced number of queries needed to populate the relationship field taxonomy filter.
  • Dev - Added 'nav_menu_item_id' and 'nav_menu_item_depth' to get_field_groups() query.
  • Dev - Reordered various actions and filters for more usefulness.
  • i18n - Updated Polish language thanks to Dariusz Zielonka

5.7.5

Release Date - 6 September 2018

  • Fix - Fixed bug causing multisite login redirect issues.
  • Fix - Fixed bug causing validation issues in older versions of Firefox.
  • Fix - Fixed bug causing duplicate Select2 instances when adding a widget via drag/drop.
  • Dev - Improved WPML compatibility by using $sitepress->get_current_language() instead of ICL_LANGUAGE_CODE.
  • Dev - Improved validation JS with new Validator model and logic.

5.7.4

Release Date - 30 August 2018

  • Fix - Fixed bug causing field groups to disappear when selecting a taxonomy term with WPML active.
  • Tweak - Added more Dark Mode styles.
  • Tweak - Improved DB upgrade prompt, functions and AJAX logic.
  • Tweak - Improved the "What's New" admin page seen after DB Upgrade.
  • Dev - Added new location rules filters.

5.7.3

Release Date - 20 August 2018

  • New - Added Dark Mode styles for the Dark Mode Plugin.
  • New - Added "Value Contains" condition to the Select field type.
  • New - Added support for the WooCommerce product type dropdown to trigger "update metaboxes".
  • Tweak - Improved acf.screen model responsible for "updating metaboxes" when changing post data.
  • Tweak - Removed user fields from the multisite "Add New User" page.
  • Fix - Fixed bug preventing some tinymce customizations from working.
  • Fix - Fixed JS bug throwing "preference" error in console.
  • Dev - Added action 'acf/enqueue_uploader' triggered after the hidden "ACF Content" editor is rendered.

5.7.2

Release Date - 6 August 2018

  • Fix - Fixed bug preventing the Google Maps Field address from being customised.
  • Fix - Improved logic to request and cache plugin update information.
  • Fix - Fixed bug preventing JS initialization when editing widgets in accessibility mode.
  • Fix - Added missing $parent argument to term_exists() function when adding a new term via taxonomy field popup.
  • Fix - Fixed bug where nested Group Fields did not delete their values.
  • Fix - Fixed JS error thrown by localStorage if cookies are not enabled.
  • Dev - Bumped minimum WP version requirement to 4.4.
  • Dev - Added action 'wp_nav_menu_item_custom_fields' for compatibility with other plugins modifying the menu walker class.
  • Dev - Added 'multiple' to the allowed attributes for an email field.
  • Dev - Added new ACF_Ajax class for upcoming features.

5.7.1

  • Core: Minor fixes and improvements

5.7.0

  • Core: Major JavaScript updates
  • Core: Improved conditional logic with new types and more supported fields
  • Core: Improved localization and internationalization
  • Repeater field: Improved logic that remembers collapsed row states
  • Repeater field: Added support to collapse multiple rows (hold shift)
  • API: Improved lookup to find fields without a reference value
  • Language: Added Croatian translation - Thanks to Vlado Bosnjak
  • Language: Updated Italian translation - thanks to Davide Pantè
  • Language: Updated Romanian translation - thanks to Ionut Staicu
  • Language: Updated German translation - thanks to Ralf Koller
  • Language: Updated Arabic translation - thanks to Karim Ramadan
  • Language: Updated Portuguese translation - thanks to Pedro Mendonça

5.6.10

  • Core: Minor fixes and improvements

5.6.9

  • User field: Added new 'Return Format' setting (Array, Object, ID)
  • Core: Added basic compatibility with Gutenberg - values now save
  • Core: Fixed bug affecting the loading of fields on new Menu Items
  • Core: Removed private ('show_ui' => false) post types from the 'Post Type' location rule choices
  • Core: Minor fixes and improvements
  • Language: Updated French translation - thanks to Maxime Bernard-Jacquet

5.6.8

  • API: Fixed bug causing have_rows() to fail with PHP 7.2
  • Core: Fixed bug causing "Add new term" form to hide after submit
  • Core: Minor fixes and improvements
  • Language: Updated German translation - thanks to Ralf Koller
  • Language: Updated Portuguese translation - thanks to Pedro Mendonça
  • Language: Updated Arabic translation - thanks to Karim Ramadan
  • Language: Updated Spanish translation - thanks to Luis Rull Muñoz
  • Language: Updated Persian translation - thanks to Majix

5.6.7

  • Fixed an assortment of bugs found in 5.6.6

5.6.6

  • Accordion field: Added new field type
  • Tab field: Added logic to remember active tabs
  • WYSIWYG field: Fixed JS error in quicktags initialization
  • Core: Fixed issue preventing conditional logic for menu item fields
  • Core: Fixed issue preventing JS initialization for newly added menu items.
  • Core: Allow whitespace in input value (previously trimmed)
  • Core: Minor fixes and improvements
  • Language: Updated Italian translation - thanks to Davide Pantè
  • Language: Updated Brazilian Portuguese translation - thanks to Rafael Ribeiro
  • Language: Updated Dutch translation - thanks to Derk Oosterveld
  • Language: Updated Portuguese translation - thanks to Pedro Mendonça
  • Language: Updated Persian translation - thanks to Kamel Kimiaei
  • Language: Updated Swiss German translation - thanks to Raphael Hüni
  • Language: Updated Arabic translation - thanks to Karim Ramadan

5.6.5

  • API: Added new 'kses' setting to the acf_form() function
  • Core: Added new 'Admin Tools' framework (includes design refresh)
  • Core: Minor fixes and improvements
  • Language: Update Ukrainian translation - thanks to Jurko Chervony
  • Language: Update Russian translation - thanks to Andriy Toniyevych
  • Language: Update Hebrew translation - thanks to Itamar Megged

5.6.4

  • Google Map field: Fixed bug causing invalid url to JavaScript library
  • WYSIWYG field: Fixed minor z-index and drag/drop bugs
  • Group field: Fixed bug causing incorrect export settings
  • Core: Fixed bug in 'Post Taxonomy' location rule ignoring selected terms during AJAX callback
  • Core: Fixed bug preventing a draft to validate with required fields
  • Language: Updated Italian translation - thanks to Davide Pantè
  • Language: Update Turkish translation - thanks to Emre Erkan
  • Language: Updated Chinese translation - thanks to Wang Hao
  • Language: Update Hebrew translation - thanks to Itamar Megged

5.6.3

  • Button Group field: Added new field type
  • Range field: Added missing 'step' attribute to number input
  • Range field: Added width to number input based on max setting
  • Basic fields: Added missing 'required' attribute to inputs
  • Basic fields: Removed empty attributes from inputs
  • API: Fixed get_fields() bug ignoring fields starting with an underscore
  • Core: Minor fixes and improvements
  • Language: Updated Portuguese translation - thanks to Pedro Mendonça
  • Language: Updated French translation - thanks to Maxime Bernard-Jacquet
  • Language: Updated Finnish translation - thanks to Sauli Rajala
  • Language: Updated German translation - thanks to Ralf Koller

5.6.2

  • Range field: Added new field type
  • Clone field: Fixed bug causing value update issues for 'seamless' + widgets / nave menu items
  • Location: Added parent theme's post templates to 'post template' location rule
  • Location: Fixed bug causing 'nav menu' location rule to fail during AJAX (add new item)
  • Core: Fixed PHP errors in customizer when editing non ACF panels
  • Core: Fixed bug casing backslash character to break fields / field groups
  • Core: Many minor bug fixes
  • Language: Updated Romanian translation - thanks to Ionut Staicu
  • Language: Updated Italian translation - thanks to Davide Pantè
  • Language: Update Turkish translation - thanks to Emre Erkan
  • Language: Updated Russian translation - Thanks to Алекс Яровиков
  • Language: Updated French translation - Thanks to Julie Arrigoni

5.6.1

  • Fixed an assortment of bugs found in 5.6.0

5.6.0

  • Link field: Added new field type
  • Group field: Added new field type
  • API: Improved have_rows() function to work with clone and group field values
  • Core: Added new location for Menus
  • Core: Added new location for Menu Items
  • Core: Added types to Attachment location rule
  • Core: Added "Confirm Remove" tooltips
  • Core: Updated Select2 JS library to v4
  • Core: Minor fixes and improvements

5.5.14

  • Core: Minor bug fixes

5.5.13

  • Clone field: Improved 'Fields' setting to show all fields within a matching field group search
  • Flexible Content field: Fixed bug causing 'layout_title' filter to fail when field is cloned
  • Flexible Content field: Added missing 'translate_field' function
  • WYSIWYG field: Fixed JS error when using CKEditor plugin
  • Date Picker field: Improved 'Display Format' and 'Return Format' settings UI
  • Time Picker field: Same as above
  • Datetime Picker field: Same as above
  • Core: Added new 'remove_wp_meta_box' setting
  • Core: Added constants ACF, ACF_PRO, ACF_VERSION and ACF_PATH
  • Core: Improved compatibility with Select2 v4 including sortable functionality
  • Language: Updated Portuguese translation - thanks to Pedro Mendonça

5.5.12

  • Tab field: Allowed HTML within field label to show in tab
  • Core: Improved plugin update class
  • Language: Updated Portuguese translation - thanks to Pedro Mendonça
  • Language: Updated Brazilian Portuguese translation - thanks to Rafael Ribeiro

5.5.11

  • Google Map field: Added new 'google_map_init' JS action
  • Core: Minor fixes and improvements
  • Language: Updated Swiss German translation - thanks to Raphael Hüni
  • Language: Updated French translation - thanks to Maxime Bernard-Jacquet

5.5.10

  • API: Added new functionality to the acf_form() function:
    • added new 'html_updated_message' setting
    • added new 'html_submit_button' setting
    • added new 'html_submit_spinner' setting
    • added new 'acf/pre_submit_form' filter run when form is successfully submit (before saving $_POST)
    • added new 'acf/submit_form' action run when form is successfully submit (after saving $_POST)
    • added new '%post_id%' replace string to the 'return' setting
    • added new encryption logic to prevent $_POST exploits
    • added new acf_register_form() function
  • Core: Fixed bug preventing values being loaded on a new post/page preview
  • Core: Fixed missing 'Bulk Actions' dropdown on sync screen when no field groups exist
  • Core: Fixed bug ignoring PHP field groups if exists in JSON
  • Core: Minor fixes and improvements

5.5.9

  • Core: Fixed bug causing ACF4 PHP field groups to be ignored if missing ‘key’ setting

5.5.8

  • Flexible Content: Added logic to better 'clean up' data when re-ordering layouts
  • oEmbed field: Fixed bug causing incorrect width and height settings in embed HTML
  • Core: Fixed bug causing incorrect Select2 CSS version loading for WooCommerce 2.7
  • Core: Fixed bug preventing 'min-height' style being applied to floating width fields
  • Core: Added new JS 'init' actions for wysiwyg, date, datetime, time and select2 fields
  • Core: Minor fixes and improvements

5.5.7

  • Core: Fixed bug causing get_field() to return incorrect data for sub fields registered via PHP code.

5.5.6

  • Core: Fixed bug causing license key to be ignored after changing url from http to https
  • Core: Fixed Select2 (v4) bug where 'allow null' setting would not correctly save empty value
  • Core: Added new 'acf/validate_field' filter
  • Core: Added new 'acf/validate_field_group' filter
  • Core: Added new 'acf/validate_post_id' filter
  • Core: Added new 'row_index_offset' setting
  • Core: Fixed bug causing value loading issues for a taxonomy term in WP < 4.4
  • Core: Minor fixes and improvements

5.5.5

  • File field: Fixed bug creating draft post when saving an empty value
  • Image field: Fixed bug mentioned above

5.5.4

  • File field: Added logic to 'connect' selected attachment to post (only if attachment is not 'connected')
  • File field: Removed filesize() call causing performance issues with externally hosted attachments
  • File field: Added AJAX validation to 'basic' uploader
  • Image field: Added 'connect' logic mentioned above
  • Image field: Added AJAX validation mentioned above
  • True false field: Improved usability by allowing 'tab' key to focus element (use space or arrow keys to toggle)
  • Gallery field: Fixed bug causing unsaved changes in sidebar to be lost when selecting another attachment
  • API: Fixed add_row() and add_sub_row() return values (from true to new row index)
  • Core: Improved get_posts() query speeds by setting 'update_cache' settings to false
  • Core: Allowed 'instruction_placement' setting on 'widget' forms (previously set always to 'below fields')
  • Core: Removed 'ACF PRO invalid license nag' and will include fix for 'protocol change' in next release
  • Language: Updated French translation - thanks to Martial Parfait

5.5.3

  • Options page: Fixed bug when using WPML in multiple tabs causing incorrect 'lang' to be used during save.
  • Core: Added support with new get_user_locale() setting in WP 4.7
  • Core: Improved efficiency of termmeta DB upgrade logic
  • Core: Minor fixes and improvements

5.5.2

  • Tab field: Fixed bug causing value loading issues for field's with the same name
  • Repeater field: Fixed bug in 'collapsed' setting where field key was shown instead of field label

5.5.1

  • Select field: Fixed bug preventing some field settings from being selected
  • Date picker field: Improved compatibility with customised values
  • Core: Added new 'enqueue_datepicker' setting which can be used to prevent the library from being enqueued
  • Core: Added new 'enqueue_datetimepicker' setting which can be used to prevent the library from being enqueued
  • Core: Minor fixes and improvements

5.5.0

  • True False field: Added new 'ui' setting which renders as a toggle switch
  • WYSIWYG field: Added new 'delay' setting which delays tinymce initialization until the field is clicked
  • WYSIWYG field: Added compatibility for WP 4.7 toolbar buttons order
  • Checkbox field: Added new 'allow_custom' and 'save_custom' settings allowing you to add custom choices
  • Select field: Fixed bug where Select2 fields did not correctly use the ‘allow null’ setting
  • Clone field: Fixed bug causing save/load issues found when 2 sub fields clone in the same field/group.
  • Flexible Content field: Improved popup style and validation messages
  • Google Map field: Prevent scroll zoom
  • Date picker field: Added better compatibility logic for custom 'date_format' setting found in version < 5.0.0
  • API: acf_form() 'id' setting is now used as 'id' attribute in
    element
  • Options page: Fixed incorrect redirect URL from a sub options page
  • Field group: Added new 'post_template' location rule (requires WP 4.7)
  • Core: Added support for the wp_termmeta table (includes DB upgrade)
  • Core: Added new 'select_2_version' setting which can be changed between 3 and 4
  • Core: Added new 'enqueue_select2' setting which can be used to prevent the library from being enqueued
  • Core: Added new 'enqueue_google_maps' setting which can be used to prevent the library from being enqueued
  • Core: Minor fixes and improvements
  • Language: Updated Portuguese translation - thanks to Pedro Mendonça
  • Language: Updated Norwegian translation - thanks to Havard Grimelid
  • Language: Updated Swedish translation - thanks to Jonathan de Jong
  • Language: Updated German translation - thanks to Ralf Koller
  • Language: Updated Italian translation - thanks to Davide Pantè
  • Language: Updated Swiss German translation - thanks to Raphael Hüni

5.4.8

  • Flexible Content field: Fixed bug in 'layout_title' filter preventing values being loaded correctly

5.4.7

  • Time Picker field: Fixed bug preventing default time from being selected
  • Date Picker field: Improved compatibility with unix timestamp values
  • File field: Fixed validation bugs when used as a sub field (multiple selection)
  • Select field: Fixed bug incorrectly allowing a disabled field (hidden by conditional logic) to save values
  • API: Added new add_sub_row() function
  • API: Added new update_sub_row() function
  • API: Added new delete_sub_row() function
  • Core: Fixed bug causing 'sync' issues with sub clone fields
  • Core: Minor fixes and improvements

5.4.6

  • Gallery field: Fixed bug where open sidebar fields were saved to post
  • Flexible Content field: Fixed bug causing Google map render issue within collapsed layout
  • Flexible Content field: Fixed bug during 'duplicate layout' where radio input values were lost
  • API: Fixed bug causing get_row(true) to return incorrect values
  • Core: Fixed bug where preview values did not load for a draft post
  • Core: Added notice when PRO license fails to validate URL
  • Core: Fixed bug where conditional logic would incorrectly enable select elements
  • Core: Minor fixes and improvements

5.4.5

  • API: Fixed bug in acf_form() where AJAX validation ignored 'post_title'
  • API: Improved update_field() when saving a new value (when reference value does not yet exist)
  • Core: Added search input & toggle to admin field groups list
  • Core: Fixed bug where preview values did not load for a draft post

5.4.4

  • WYSIWYG field: Fixed JS error when 'Disable the visual editor when writing' is checked

5.4.3

  • WYSIWYG field: Fixed JS bug (since WP 4.6) causing conflicts with editor plugins
  • Google Maps field: Fixed JS error conflict with Divi theme
  • Radio field: Fixed bug (Chrome only) ignoring default values in cloned sub fields
  • Core: Fixed wp_get_sites() deprecated error (since WP 4.6) shown in network admin

5.4.2

  • API: Fixed bug preventing post_title and post_content values saving in acf_form()

5.4.1

  • API: Fixed bug causing get_fields('options') to return false
  • Core: Fixed bug causing get_current_screen() to throw PHP error
  • Core: Fixed bug causing 'Preview Post' to load empty field values

5.4.0

  • Clone field: Added new field type (https://www.advancedcustomfields.com/resources/clone/)
  • Gallery field: Removed 'Preview Size' setting and improved UI
  • Taxonomy field: Added compatibility to save/load terms to user object
  • Select field: Added new 'Return Format' setting
  • Radio field: Added new 'Return Format' setting
  • Checkbox field: Added new 'Return Format' setting
  • Page link field: Added new 'Allow Archives URLs' setting
  • Core: Fixed plugin update bug delaying updates
  • Core: Fixed bug when editing field settings in Chrome causing required setting to self toggle
  • Core: Improved speed and fixed bugs when creating and restoring revisions
  • Core: Minor fixes and improvements
  • Language: Updated Portuguese translation - thanks to Pedro Mendonça
  • Language: Updated Brazilian Portuguese translation - thanks to Augusto Simão
  • Language: Updated Dutch translation - thanks to Derk Oosterveld
  • Language: Updated Persian translation - thanks to Kamel
  • Language: Updated German translation - thanks to Ralf Koller
  • Language: Updated Swiss German translation - thanks to Raphael Hüni

5.3.10

  • Core: Added new 'google_api_key' and 'google_api_client' global settings
  • Google Map: Added new 'acf/fields/google_map/api' filter

5.3.9.2

  • Time Picker field: Added compatibility with previous 3rd party field settings
  • Core: Fixed JS error setting l10n for Select2 with 3rd party libraries

5.3.9.1

  • Time Picker field: Fixed bug causing value to appear as current time
  • API: Fixed bug causing have_rows() to fail when using an object as $post_id parameter

5.3.9

  • Date Time Picker field: Added new field
  • Time Picker field: Added new field
  • Taxonomy field: Fixed bug preventing saved terms from being loaded during save/update actions
  • API: Added new function the_row_index() to output the current row number (1,2,3)
  • Core: Improved import tool to update existing field groups
  • Core: Added upgrade_notice message to plugins page for future announcements
  • Core: Fixed bug where updating value did not clear persistent cache
  • Core: Added Select2 JS strings to .pot for translation
  • Core: Added Date and Time picker JS strings to .pot for translation
  • Core: Improved compatibility with WPML during AJAX calls
  • Core: Fixed bug preventing access to network database upgrade page
  • Core: Minor fixes and improvements
  • Language: Updated Swedish translation - thanks to Jonathan de Jong
  • Language: Updated Russian translation - thanks to Andy Toniyevych
  • Language: Updated Portuguese translation - thanks to Pedro Mendonça
  • Language: Updated Polish translation - thanks to Michal Lepiarz
  • Language: Updated Italian translation - thanks to Davide Pantè
  • Language: Updated German translation - thanks to Ralf Koller
  • Language: Added Arabic translation - thanks to Adil el hallaoui

5.3.8.1

  • Image field: Fixed JS bug causing errors when 'Uploaded to post' library setting is checked
  • File field: Same as above
  • Gallery field: Same as above
  • Flexible Content field: Fixed bug preventing get_sub_field() from working within 'layout_title' filter
  • Radio field: Fixed bug causing field name to change when adding 'other' choice to a sub field

5.3.8

  • Gallery field: Added new 'Insert' setting to control where new attachments are added
  • Radio field: Added new 'Allow Null' setting
  • Relationship field: Added attachment mime type icons when no thumbnail is available
  • Core: Fixed bug causing customizer preview values from loading on newly added widgets
  • Core: Improved attachments location rule for future compatibility with specific mime types
  • Core: Fixed bug causing select2 to appear blank after duplicating a field setting
  • Core: Fixed bug causing PHP error on front-end plugin update check
  • Core: Updated title elements (h1, h2, h3) to match WP 4.5
  • Core: Minor fixes and improvements
  • Core: Fixed bug where comment fields appeared in different locations for logged in/out users
  • Language: Updated Polish translation - thanks to Michal Lepiarz
  • Language: Updated Italian translation - thanks to Davide Pantè
  • Language: Updated Portuguese translation - thanks to Pedro Mendonça
  • Language: Updated Swiss German translation - thanks to Raphael Hüni
  • Language: Updated French Translation - thanks to Maxime Bernard-Jacquet

5.3.7

  • Options page: Added new 'update_button' setting to modify update button text
  • Options page: Added columns support (Screen Options)
  • Core: Added widget preview / save compatibility with the customizer
  • Core: Minor fixes and improvements
  • Language: Updated German translation - thanks to Ralf Koller
  • Language: Updated French Translation - thanks to Maxime Bernard-Jacquet

5.3.6.1

  • Flexible Content field: Fixed PHP error in 'acf/fields/flexible_content/layout_title' filter (when used as a sub field)
  • Core: Fixed bug causing get_field() to load from the incorrect post (when within a custom WP_Query loop)

5.3.6

  • Flexible Content field: Added new 'acf/fields/flexible_content/layout_title' filter to customize layout title
  • Image field: Fixed bug where searching within media library would ignore restriction settings
  • File field: Same as above
  • Field group: Added post types to comment form location rules
  • Color Picker field: Added 'color_picker_args' JS filter to modify wpColorPicker args
  • API: Improved get_ functions to load value from the current queried object (post, user, term)
  • Core: Added new 'acf/translate_field' filter to translate field settings text
  • Core: Added new 'acf/translate_field_group' filter to translate field group settings text
  • Core: Removed 'l10n_field' and 'l10n_field_group' settings
  • Core: Fixed bug causing 'acf/input/admin_head' action to run twice
  • Core: Added support for new WP 4.5 term edit page
  • Core: Moved google map and wysiwyg JS initialisation later in the page load to help speed up edit screens
  • Core: Minor fixes and improvements

5.3.5

  • User field: Fixed pagination bug causing missing results
  • Core: Added new filter 'acf/location/screen' to customize location rules matching args
  • Core: Minor fixes and improvements
  • Language: Updated Dutch translation - thanks to Derk Oosterveld
  • Language: Updated Italian translation - thanks to Davide Pantè
  • Language: Added Swiss German translation - thanks to Raphael Hüni

5.3.4

  • User field: Added pagination for Select2 results
  • Tab field: Fixed issue where no tab was active within a widget
  • Taxonomy field: Fixed issue where term order was lost when using 'load_terms' setting
  • Image field: Alt tag will now update when editing/changing selected image
  • Field group: Removed Comic sans 'Drag/drop' text (OMG)
  • Core: Changed button classes from '.acf-button' to '.button'
  • Core: Fixed double __() issue when exporting field group with new l10n settings
  • Core: Removed some 'wp_cache_delete()' functions to improve load speed on heavily cached websites
  • Core: Removed esc_html() from field label and added new filter 'acf/get_field_label'
  • Core: Minor fixes and improvements
  • API: Added new 'honeypot' setting to the acf_form() function
  • Language: Added Bulgarian translation - thanks to Marin Atanasov
  • Language: Added Swiss German translation - thanks to Raphael Hüni
  • Language: Added Indonesian translation - thanks to Rio Bermano

5.3.3.2

  • Core: Fixed bug preventing new translation settings 'l10n_field' and 'l10n_field_group'
  • Core: Fixed bug preventing plugin updates when included within theme
  • Core: Added esc_html() to field label

5.3.3.1

  • Tab field: Fixed bug causing issues with conditional logic
  • WYSIWYG field: Fixed PHP error on front end form

5.3.3

  • Google Maps field: Fixed bug where pasting value did not trigger auto complete
  • Select field: Improved Select2 search matching for special characters
  • Select field: Improved asset loading to allow other Select2 libraries to load first
  • Select field: Added compatibility for both Select2 v3 and v4
  • WYSIWYG field: Added new responsive images filter to the 'acf_the_content' filter
  • oEmbed field: Added compatibility for custom oEmbed handlers
  • Flexible Content field: Fixed bug causing sub fields to move when duplicating layouts
  • Core: Added new translation settings 'l10n', 'l10n_textdomain', 'l10n_field' and 'l10n_field_group'
  • Core: Improved Export to PHP feature which now uses the above translation settings
  • Core: Fixed PHP error preventing new field groups from loading when editing a post
  • Core: Added hierarchy to taxonomy terms shown in drop down elements
  • Core: Improved update logic to ignore plugin when included within a theme / plugin
  • API: Improved acf_form() loading efficiency when using 'new_post' setting
  • API: Improved add_row() function to work when no value exists
  • API: Added new function get_row_index() to use within the have_rows() loop
  • Language: Updated Polish translation - thanks to Michal Lepiarz
  • Language: Updated Persian translation - thanks to Kamel
  • Language: Updated Spanish translation - thanks to Federico Schäfer
  • Language: Updated Norwegian translation - thanks to Havard Grimelid
  • Language: Updated Swedish translation - thanks to Björn Göransson

5.3.2.2

  • Core: Fixed PHP error when registering a local field missing one of more settings
  • Core: Fixed incorrect json load_path setting when WPML is active
  • Language: Updated Polish translation - thanks to Michal Lepiarz

5.3.2.1

  • Core: Fixed bug causing issues when loading values from an options page, widget or taxonomy term

5.3.2

  • Repeater field: Added new setting and icon to collapse row
  • Google Maps: Improved google API loading for better theme compatibility
  • Taxonomy field: Fixed bug where 'Add new term' popup only showed 20 parent terms
  • Core: Added new setting 'export_translate' to customise which field settings should be wrapped in __()
  • Core: Improved efficiency of AJAX call when finding new field groups when editing a post
  • API: Added new functions add_row(), update_row() and delete_row()
  • Language: Updated German translation - thanks to Ralf Koller
  • Language: Updated Italian translation - thanks to Davide Pantè
  • Language: Updated Dutch translation - thanks to Derk Oosterveld
  • Language: Updated Portuguese translation - thanks to Augusto Simão

5.3.1

  • Flexible Content field: added toggle icons to show layout open/close state
  • Gallery field: Fixed bug where images could not save a blank title value
  • Taxonomy field: Added pagination when rendered as a Select2 element
  • Relationship field: Changed validation to better edit values when a minimum is set
  • Google map field: Fixed minor autocomplete bugs and added search icon
  • Message field: Added new_lines setting
  • Core: Added '*' to required fields when editing a field group
  • Core: Prevented updates to .json file when syncing
  • Core: Fields now render as div (instead of table) when labels are left aligned
  • Core: Minor fixes and improvements
  • Language: Updated .po headers - thanks to Ralf Koller

5.3.0

  • WYSIWYG field: Fixed 'Visual/Text' toggle bug with WP 4.3
  • Select field: Fixed Select2 bug hiding selected choices

5.2.9

  • Field group: Added new 'status' setting to enable/disable
  • Field group: Added new 'description' setting shown to developers when viewing the field group list
  • Field group: Moved 'Show field keys' Screen Option within existing 'Show on Screen' checkboxes
  • Tab field: Fixed missing min-height to left aligned tab wrapper
  • Relationship field: Added timeout to reduce AJAX requests whilst typing in search
  • Flexible Content field: Fixed minor JS bug where removing a layout would not update the order numbers
  • Core: Fixed bug validating uppercase file extensions
  • Core: Renamed menu items
  • Core: Replace sprite icons with font
  • Core: Added new setting 'export_textdomain' to add __() to generated export code
  • Core: Fixed conflict with Post Type Order plugin causing issues when querying posts
  • Core: Fixed conflict with WPML causing issues when querying posts
  • Core: Added compatibility for WP 4.3
  • Core: Minor fixes and improvements
  • Language: Updated German translation - thanks to Ralf Koller
  • Language: Updated Italian translation - thanks to Davide Pantè

5.2.8

  • Image field: Added selection restrictions in media popup (width, height, size, type)
  • File field: Same as above
  • Gallery field: Same as above
  • Tab field: Added new 'endpoint' setting - allows multiple tab groups
  • Tab field: Improved CSS/JS to allow individual tab groups to use different alignments (left/top)
  • Repeater field: Added logic to delete nested sub field values (grand children)
  • Options page: Added new 'autoload' setting
  • Core: Added new filter 'acf/prepare_field'
  • Core: Added upload validation logic to ignore filetype case sensitivity
  • Core: Fixed upload issue when filesize restriction contained a decimal place
  • Core: Improved validation/save JS compatibility with 3rd party plugins
  • Core: Updated Select2 library to v3.5.2
  • Core: Fixed bug hiding Select2 choices when multiple found with the same label
  • Core: Minor fixes and improvements
  • Language: Updated Italian translation - thanks to Davide Pantè & Francesco Mazzola
  • Language: Updated German translation - thanks to Ralf Koller
  • Language: Updating Finnish translation - thanks to Sauli Rajala

5.2.7

  • Taxonomy field: Split setting 'load_save_terms' into 'load_terms' and 'save_terms'
  • Select field: Fixed bug causing values containing ',' to fail
  • Checkbox field: Fixed bug causing values containing ',' to fail
  • Checkbox field: Added new 'toggle all' setting
  • User field: Added new filters 'acf/fields/user/result' and 'acf/fields/user/search_columns'
  • Gallery field: Added logic to increase sidebar width when space is available
  • Options page: Added new 'post_id' setting to customise where values are loaded and saved
  • API: Improved get_field() to better handle no value
  • API: Optimised asset loading when using the acf_form() function
  • API: Added new function delete_sub_field()
  • Core: Added new acf/init action when ACF has loaded all functionality
  • Core: Added compatibility with Select2 language translations
  • Core: Changed compatibility filter default to false
  • Core: Minor fixes and improvements
  • Language: Updated German translation - thanks to Thomas Meyer
  • Language: Updated French Translation - thanks to Maxime Bernard-Jacquet
  • Language: Updated Persian translation - thanks to Kamel

5.2.6

  • Core: Improved validation logic to display HTML5 validation messages
  • Core: Improved conditional logic performance for large field groups
  • Core: Removed updates menu item when not activated as a plugin (included within theme)
  • Core: Fixed various JS performance issues
  • Core: Minor fixes and improvements
  • Core: Added compatibility for saving widget in 'accessibility mode'
  • Language: Added Finnish translation - thanks to Sauli Rajala

5.2.5

  • Core: Fixed JS error preventing changes to large field groups
  • Language: Added Romanian translation - thanks to Eduard Ungureanu

5.2.4

  • WYSIWYG field: Fixed bug where new editor is not focused when adding media
  • Core: Added new 'uploader' setting to acf_form() options for basic upload inputs
  • Core: Fixed Multisite loop when WordPress MU Domain Mapping plugin is active
  • Core: Improved CSS when editing taxonomy terms and users
  • Core: Fixed validation bugs when clicking save or preview
  • Core: Added compatibility with WPML translations when field group is not set as a translatable post type
  • Core: Many minor fixes and improvements

5.2.3

  • Taxonomy field: Added button and popup to create new terms
  • Taxonomy field: Added new 'Create Terms' setting to prevent popup
  • Core: Added network database upgrade admin page and functionality
  • Core: Increased required WP version from 3.5 to 3.6
  • Core: Fixed Select2 dependancy conflict with WooCommerce
  • Core: Fixed WPML bug where field group translation information is lost
  • Core: Fixed conditional logic bug where showing a parent field would override sub field conditional logic
  • Core: Minor fixes and improvements
  • Language: Updated Persian translation - thanks to Kamel

5.2.2

  • Image field: Fixed UI bug when image has been removed via media library
  • Relationship field: Added new minimum selection setting
  • Select field: Fixed bug when searching for a numeric value
  • Tab field: Fixed conditional logic bug
  • Field group: Added compatibility for custom status in 'Post Status' location rule
  • Core: Added new show_updates setting to prevent plugin updates
  • Core: Added compatibility for 3rd party update management websites
  • Core: Added spinner when saving taxonomy term, user and front end form
  • Core: Minor fixes and improvements
  • Language: Updated Slovak translation - thanks to Ján Fajčák

5.2.1

  • Core: Fixed bug where 'Taxonomy' field group location rule would change to 'Post Taxonomy'
  • Core: Fixed bug where field group postboxes would disappear from post edit screen
  • Core: Fixed bug where 'Uploaded to post' setting would not work on front end image/file/gallery fields
  • Core: Fixed bug where multiple conditional logic tabs would not display correctly
  • Language: Updated Japanese translation - thanks to Shogo Kato

5.2.0

  • Taxonomy field: Fixed bug where term relationships were not saved when using the update_field() function
  • Taxonomy field: Added compatibility for upcoming 'term splitting' in WP 4.2
  • Image field: Fixed bug causing 'Uploaded to post' setting to not filter the medial library
  • Gallery field: Added 'attachment_fields_to_save' filter for 3rd party custom field support
  • Field group: Added new location rule 'Current User'
  • Field group: Renamed location rule 'Logged in User Type' to 'Current User Role'
  • Field group: Removed location group 'Basic' and moved location rule 'Post Type' into group 'Posts'
  • Core: Fixed bug where postbox would disappear after save
  • Core: Fixes bug where sub fields are duplicated during sync
  • Core: Minor fixes and improvements
  • Language: Updated German translation - thanks to Ralf Koller
  • Language: Updated Dutch translation - thanks to Patrick Heiloo

5.1.9.1

  • Language: Fixed corrupt language files

5.1.9

  • Image field: Added new settings to restrict uploads (width, height, size, type)
  • File field: Same as above
  • Gallery field: Same as above
  • Message field: Added new esc_html setting to show HTML as plain text
  • Core: Fixed customizer issues when editing widgets
  • Core: Added new filter to validate upload - https://www.advancedcustomfields.com/resources/acfupload_prefilter/
  • Core: Added file types (new field setting) to media popup select filter
  • Core: Added an edit field group link to metabox titles
  • Core: Added new capability setting for use in admin pages / CPT
  • Core: Minor fixes and improvements
  • Language: Updated Portuguese (Brazil) translation - thanks to augustoms
  • Language: Updated Hebrew translation - thanks to Ahrale
  • Language: Updated Swedish translation - thanks to Fredrik Andersson
  • Language: Updated Russian translation - thanks to Alexey Samoylov
  • Language: Updated Ukrainian translation - thanks to Jurko Chervony

5.1.8

  • WYSIWYG field: Fixed bug causing formatting issue when drag/drop
  • Tab field: Fixed UI glitch where left aligned tabs would get cut off in small field group
  • Message field: Added missing wrapper settings
  • Core: Minor fixes and improvements
  • Language: Updated Swedish translation - thanks to Andy Toniyevych

5.1.7.1

  • Core: Fixed JS error on data input screens
  • Core: Fixed incorrect return_url when using acf_form()

5.1.7

  • 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

5.1.6

  • Gallery field: More UI improvements including titles for non image attachments
  • Image field: Added more data to returned attachment including filename, icon, author and type
  • File field: Same as above
  • Gallery field: Same as above
  • Google Maps field: Fixed JS error when google object exists without maps API
  • Select field: Fixed bug where a single numeric value would not save as a default_value
  • Checkbox field: Same as above
  • Radio field: Same as above
  • API: Added $format parameter to the functions the_row() and get_row()
  • Core: Fixed bug when adding 'post_parent' value to post_object/relationship query args
  • Core: Minor fixes and improvements
  • Core: More RTL CSS improvements
  • Language: Updated Hebrew translation - thanks to Lavi Perchik
  • Language: Updated Persian translation - thanks to Kamel

5.1.5

  • Taxonomy field: Fixed bug where values would not appear selected
  • Core: Added new JSON synchronisation functionality
  • Core: Minor fixes and improvements

5.1.4

  • Taxonomy field: Major improvement to save/load setting allowing for different values on multiple sub fields
  • Google Map field: Fixed render glitch on sub fields when shown by a tab field
  • Code: Fixed bug where Select2 would continuously load when no results found
  • Core: Fixed bug where translated field groups were lost during DB migration to v5
  • Core: Minor fixes and improvements

5.1.3

  • Repeater field: Added new 'block' layout style
  • Flexible Content field: Added new 'block' layout style
  • Core: Added new field setting 'wrapper' including width, class and id
  • Core: Minor JS speed improvement for sub field conditional logic
  • Core: Minor fixes and improvements
  • Language: Updated Dutch translation - thanks to Patrick Heiloo

5.1.2

  • API: Fixed various bugs with the have_rows() function

5.1.1

  • Image field: Added basic file uploader for non logged in users
  • File field: Added basic file uploader for non logged in users
  • API: Added $format_value parameter to the functions get_sub_field, the_sub_field and get_sub_field_object
  • API: Added $load_value parameter to the function get_sub_field_object
  • API: Added logic in have_rows function to allow for either field name or key
  • Core: Reverted acf_save_post function back to an action with priority of 10.
  • Core: Fixed compatibility bug with Shopp plugin
  • Field group: Fixed bug where sub fields were deleted when moving a repeater field to another group

5.1.0

  • Google Map field: Fixed JS bug causing navigation prompt to incorrectly appear
  • Image field: Added width & height data next to preview_size settings
  • Image field: Added width & height data next to preview_size settings
  • Options page: Fixed bug where validation error would prevent submit button from working
  • Core: Fixed bug where previewing a post would fail on every odd attempt
  • Core: Fixed bug with persistent cache when editing field groups
  • Core: Added support for widget JS functionality in the customizer
  • Core: Changed stripslashes setting to false to allow values with back slashes
  • Core: Minor fixes and improvements

5.0.9

  • Options page: Added compatibility for different language values
  • Image field: Fixed bug preventing image selection
  • Select field: Fixed bug where orphaned value could not be removed
  • WYSIWYG field: Fixed bug causing issues with DFW fullscreen
  • Core: Added window scroll to validation message when not in view
  • Core: Improved JS performance when working with large scale repeater fields
  • Core: Fixed incompatibility with post type switcher plugin
  • Core: Minor fixes and improvements
  • Language: Added Turkish translation - thanks to Ramazan POLAT
  • Language: Updated Persian translation - thanks to Kamel Kimiaei

5.0.8

  • Checkbox field: Fixed PHP error when editing field default value
  • Image field: Added logic to update thumbnail after image has been edited
  • Gallery field: Added logic to update thumbnail after image has been edited
  • Core: Added compatibility for WP4 media grid
  • Core: Fixed Select2 bug where results could not be selected
  • Core: Fixed conditional logic bug showing empty cells in the repeater field
  • Core: Fixed bug where tabify would show blank field groups
  • Core: Minor bug fixes and improvements
  • Language: Added Slovakian translation - thanks to wp.sk

5.0.7

  • Core: Fixed navigation prompt when saving a field group
  • Checkbox field: Fixed issue with multiple default values (requires save)
  • Tab field: Fixed missing active tabs on page load

5.0.6

  • Relationship field: Fixed bug preventing values from being removed
  • Taxonomy field: Fixed various JS bugs
  • Core: Added logic to reset inputs after adding a new taxonomy term
  • Core: Added prompt when navigating away from changed data
  • Core: Fixed minor validation bug when tab is hidden by conditional logic
  • Core: Fixed error when showing revision of sub field data
  • Core: Minor bug fixes and improvements

5.0.5

  • Url field: Added new URL field type with basic 'http' validation
  • WYSIWYG field: Added new setting for customizing tabs (Visual / Text)
  • Relationship field: Added scrolling pagination to choices
  • Post object field: Added scrolling pagination to choices
  • Page link field: Added scrolling pagination to choices
  • Radio field: Fixed bug causing default value to be lost when added as sub field
  • Core: Minor JS improvements
  • Core: Added logic to detect if field groups are translatable (WPML setting) before modifying json path
  • Language: Updated French translation - thanks to Maxime Bernard-Jacquet

5.0.4

  • WYSIWYG field: Major improvement adding visual and text tabs
  • Image field: Fixed uploadedTo bug on non post edit page
  • Tab field: Fixed various JS bugs
  • Options page: Fixed bug causing field groups with position setting of 'High' to not appear
  • Options page: Added functionality to toggle and save state of postbox
  • Core: Fixed nested bug in get_sub_field_object()
  • Language: Updated Brazil translation - thanks to André Felipe

5.0.3

  • Gallery field: Added new edit button within sidebar to launch edit/crop popup
  • Gallery field: Changed placement of remove button when sidebar is open
  • Gallery field: Added functionality to resize height
  • Options page: Fixed default value not working
  • Core: Fixed local json issues with WPML
  • Core: Allowed local fields and groups to use custom keys (non 'field_')
  • Core: Minor bug fixes
  • Language: Updated French translation - thanks to Maxime Bernard-Jacquet

5.0.2

  • Field group: Fixed bug deleteing fields after they are moved to another group
  • Field group: Fixed PHP error preventing redirect after group is duplicated
  • Field group: Fixed blank conditional logic UI
  • Field group: Fixed taxonomy term location rule not saving
  • Image field: Added functionality to edit/crop image within popup
  • File field: Added functionality to edit/crop image within popup
  • Core: Added toggle checkbox to export field group list
  • Core: Fixed logic to include minified scripts and styles

5.0.1

  • Gallery field: Added auto save when change is detected
  • Gallery field: Added logic to better render grid with non cropped image sizes
  • Gallery field: Fixed JS error causing attachment data to not save
  • Post object field: Fixed empty value being returned for deleted posts
  • Taxonomy field: Fixed PHP error in checkbox mode when value is empty
  • User field: Fixed PHP error preventing choices from being loaded
  • Taxonomy field: Fixed null value returned on front end
  • Flexible Content field: Fixed bug preventing layouts without sub fields from loading correctly
  • Flexible Content field: Fixed bug preventing layout reorder from saving
  • Relationship field: Fixed result elements setting compatibility with ACF4
  • Field group: Added logic to remember "Show Field Keys" screen option
  • Core: Updated Select2 to v3.5.0
  • Core: Added logic to allow values to save on an empty post (no title, content, excerpt)
  • Core: Minor bug fixes
  • Language: Updated German translation - Thanks to Thomas Meyer
  • Language: Updated Hungarian translation - Thanks to Tihanyi Balázs

5.0.0

  • Overhaul of HTML & CSS
  • Migrated field & sub field settings (not values) to post objects instead of postmeta
  • Added Select2 JS for AJAX and search functionality on select lists
  • Added AJAX search functionality for Post Object, taxonomy, user and select fields
  • Added JSON read/write functionality to automatically save field groups to files (saves DB query time)
  • Added JSON import/export functionality to replace old XML style
  • Aded grouped conditional logic rules
  • New location rules allow field groups on comments
  • New location rules allow field groups on user (including registration and bbPress)
  • New location rules allow field groups on widgets
  • New API folder contains a library of functions to use in plugins and themes
  • New oembed field for easy iframe embeds
  • New Gallery field design
  • New field group options for Label placement and Instruction placement allow for an all new look!
  • New PHP + AJAX validation replaces old JS style
  • New Relationship field setting for 'Filters' (Search, Post Type, Taxonomy)
  • New field group functionality allows you to move a field between groups
  • New field group functionality allows you to drag a field between parents (repeater)
  • New Add-ons page uses an external JSON file to read in data (easy to add 3rd party fields)
  • Huge improvements to core functionality resulting in faster load times!
  • New archives group in page_link field selection
  • New functions for options page allow creation of both parent and child menu pages
  • Date picker field: Removed save_format setting. Values now save as Y:m:d h:i:s
  • Date picker field: Added return_format setting
  • Textarea field: Added new_lines setting
  • Gallery field: Added min and max selection settings
  • Select field: Added Stylised UI setting
  • Select field: Added Lazy Load AJAX setting

4.4.11

  • Core: Improved logic to better delete term meta during 'delete_term' action
  • Core: Fixed bug causing potential conflict between user and post object cache names
  • Language: Updated Italian translation - thanks to Ste Yeu

4.4.10

  • WYSIWYG field: Fixed JS error preventing tinymce from initializing

4.4.9

  • Image field: Added nicer 'Edit image' view
  • File field: Added nicer 'Edit file' view

4.4.8

  • Google Map: Added new 'acf/fields/google_map/api' filter

4.4.7

  • Relationship field: Fixed bug preventing values from being selected in WP 4.5
  • Google Map field: Fixed bug preventing map to load within repeater field
  • Core: Fixed PHP error when loading ACF values on 'The Events Calendar' (plugin) page
  • Language: Updated Portuguese translation - thanks to Pedro Mendonca

4.4.6

  • Google Map field: Improved compatibility with 3rd party plugins including Google JS API
  • API: Improved get_ functions to load value from the current queried object (post, user, term)
  • Core: Added support for new WP 4.5 term edit page
  • Language: Updated Portuguese translation - thanks to Pedro Mendonca
  • Language: Added Welsh translation - thanks to Carl Morris
  • Language: Added Indonesian translation - thanks to Rio Bermano

4.4.5

  • Core: Fixed metabox title appearing on seamless field groups
  • Language: Updated Portuguese translation
  • Language: Updated Polish translation

4.4.4

  • Field group: Fixed disabled update button after saving with empty title
  • Core: Minor fixes and improvements
  • Language: Updated Portuguese translation
  • Language: Updated French translation
  • Language: Updated Polish translation
  • Language: Added Finnish translation

4.4.3

  • WYSIWYG field: Added compatibility for WP 4.3 filters
  • Core: Minor fixes and improvements
  • Language: Updated Polish translation - thanks to Maciej

4.4.2

  • Image field: Fixed UI bug when image has been removed via media library
  • Core: Minor fixes and improvements

4.4.1

  • Taxonomy field: Added compatibility for upcoming 'term splitting' in WP 4.2
  • Taxonomy field: Major improvement to save/load setting allowing for different values on multiple sub fields
  • Core: Minor fixes and improvements

4.4.0

  • Core: Fixed depreciated warnings

4.3.9

  • Core: Added compatibility for WP4 media grid
  • Relationship field: Fixed bug showing incorrect post type
  • Language: Added Slovak translations - Thanks to wp.sk
  • Language: Added Serbo-Croatian translation - thanks to Borisa Djuraskovic
  • Language: Updating Persian translation - Thanks to Ghaem Omidi

4.3.8

  • Validation: Fixed disabled button issue in WP 3.9

4.3.7

  • WYSIWYG field: Fixed missing tinyMCE buttons in WP 3.9

4.3.6

  • Core: Improved efficiency and speed when saving values by removing ACF meta from the native WP postmeta box
  • Field Group: Fixed cache issue causing field settings to not update
  • WYSIWYG field: Added support for new tinymce 4 in WP 3.9
  • Number field: Fixed bug causing blank values to save as 0
  • Google Maps field: Fixed JS bug causing google maps to not render when Google library is already loaded
  • Validation: Fixed JS bug where hidden field groups's fields were being validated

4.3.5

  • Textarea field: Added new rows setting
  • API: Added $format_value parameter to the get_fields function
  • Core: Improved conditional logic & tab JS performance
  • Core: Removed changelog anouncement in plugins update list
  • Core: Fixed anoying wp is not defined JS error
  • Core: Added logic to load full or minified scripts using the SCRIPT_DEBUG constant
  • Core: Improved loading structure to better allow ACF functions within the functions.php file
  • Core: Fixed revisions bug causing sub field data to not restore
  • Core: Made use of WP datepicker UI
  • Field Group: Changed post location rule to show all post types
  • Field Group: Changed page location rule to show only page post type
  • Field Group: Added new filter for meta box priority acf/input/meta_box_priority
  • Language: Added missing translation support in multiple fields
  • Language: Added Hebrew translation - Thanks to Erez Lieberman
  • Language: Updating Czech translations - Thanks to webeescz

4.3.4

  • Post Object field: Fixed get_pages bug cuasing 'pages' to not appear
  • Page Link field: Fixed get_pages bug cuasing 'pages' to not appear
  • Tab field: Fixed JS bug causing multiple tab groups on page to render incorrectly
  • Language: Updated Russian translation - Thanks to Alex Torscho

4.3.3

  • Core: Updated styling to suit WP 3.8
  • Core: Added new logic to set 'autoload' to 'off' on all values saved to the wp_options table to help improve load speed
  • API: Added new logic to the $post_id parameter to accept an object of type post, user or taxonomy term
  • Tab field: Added compatibility with taxonomy term and user edit screens (table layout)
  • Tab field: Fixed JS bug causing incorrect tab to show when validation fails
  • Text field: Fixed bug causing append setting of '+50' to appear as '50'

4.3.2

  • Color Picker field: Fixed JS bug preventing wpColorPicker from updating value correctly
  • Google Map field: Added new setting for initial zoom level
  • Relationship field: minor update to fix compatibility issue with Polylang plugin
  • Relationship field: Fixed bug causing filters / actions using $field['name'] to not fire correctly
  • API: Fixed bug with have_rows/has_sub_field function where looping through multiple posts each containing nested repeater fields would result in an endless loop
  • Export: Fixed bug causing exported XML fields to become corrupt due to line breaks
  • Core: Fixed bug where duplicating a field would cause conditional logic to appear blank
  • Core: Added Conditional Logic support to hide entire column of a repeater field where max_row is 1.
  • Core: Added new field group 'hide on screen' option for 'permalink' which hides the permalink URL and buttons below the post title

4.3.1

  • API: Fixed bug with has_sub_field and have_rows functions causing complicated nested loops to produce incorrect results
  • API: Fixed bug with get_fields function preventing values to be returned from options page and taxonomy terms
  • Core: Fixed bug causing some SQL LIKE statements to not work correctly on windows servers
  • Core: Removed __() wrappers from PHP export, as these did not work as expected
  • Core: Fixed bug with get_pages() causing sort order issue in child page location rule
  • Core: Added specific position to ACF menu item to reduce conflicts with 3rd party plugins
  • JS: Fixed bug where conditional logic rules did not save when added using a '+' button above the last rule
  • Radio field: Fixed bug where 'other' would be selected when no value exists
  • WYSIWYG field: Added support for users with disabled visual editor setting
  • JS: Improved validation for fields that are hidden by a tab
  • Google maps field: Add refresh action when hidden / shown by a tab

4.3.0

4.2.2

4.2.1

4.2.0

  • IMPORTANT: ACF now requires a minimum WordPress version of 3.5.0
  • Full integration between attachments and custom fields!
  • Text field: Added new options for prepend, append, placeholder and character limit
  • Textarea field: Added new options for prepend, append, placeholder and character limit
  • Number field: Added new options for prepend, append and placeholder
  • Email field: Added new options for prepend, append and placeholder
  • Password field: Added new options for prepend, append and placeholder
  • Image field: fixed safari bug causing all images to appear small
  • Core: Improved save_lock functionality to prevent inifinite loops when creating a post on the fly
  • Core: Major JS improvements including .live changed to .on
  • Compatibility: Fixed WYSIWYG JS bug with Visual Composer plugin
  • Language: Added Persian Translation - thanks to Ghaem Omidi
  • Language: Updated German translation - thanks to Thomas Meyer
  • Language: Added Swedish translation - thanks to Mikael Jorhult

4.1.8.1

4.1.8

4.1.7

4.1.6

4.1.5.1

  • Image field: Fixed JS error causing uploader to not work correctly
  • File field: Fixed JS error causing uploader to not work correctly
  • Gallery field: Fixed JS error causing uploader to not work correctly
  • General: Fixed JS error causing field groups to not appear when dynamically loaded

4.1.5

4.1.4

4.1.3

4.1.2

4.1.1

  • [Fixed] Relationship field: Fix bug causing sub field to not load $field object / use elements option correctly
  • [Updated] Update German translations

4.1.0

  • [Added] Field group: location rules can now be grouped into AND / OR statements
  • [Added] Relationship field: Add option for filters (search / post_type)
  • [Added] Relationship field: Add option for elements (featured image / title / post_type)
  • [Added] Relationship field: Add post_id and field parameters to both ajax filter functions
  • [Added] Date Picker field: Add options for first_day
  • [Added] Date Picker field: Add text strings for translation
  • [Added] Select field: Add support for multiple default values
  • [Added] Checkbox field: Add support for multiple default values - http://support.advancedcustomfields.com/discussion/5635/checkbox-field-setting-multiple-defaults
  • [Updated] Minor JS + CSS improvements
  • [Added] Added free Add-ons to the admin page
  • [Fixed] Fixed minor bugs

4.0.3

4.0.2

4.0.1

4.0.0

3.5.8.1

  • [Fixed] Fix PHP error in text / textarea fields

3.5.8

3.5.7.2

3.5.7.1

  • [Fixed] Fix issues with location rules wrongly matching

3.5.7

3.5.6.3

  • [Fixed] Fix bug with 3.5.6 not showing front end form

3.5.6.2

  • [Fixed] Fix WYSIWYG webkit browser issues.

3.5.6.1

  • [Fixed] Fix bug causing field groups to not display on the options page.

3.5.6

3.5.5

3.5.4.1

  • [Fixed] Fix bug preventing options pages from appearing in the field group's location rules

3.5.4

3.5.3.1

  • Minor bug fixes for 3.5.3

3.5.3

3.5.2

  • Security update

3.5.1

3.5.0

3.4.3

3.4.2

3.4.1

3.4.0

3.3.9

3.3.8

3.3.7

3.3.6

3.3.5

  • [Fixed] Fix location rule bug for taxonomy.

3.3.4

3.3.3

  • [Upgrade] Database Upgrade is required to modify the taxonomy filtering data for fields. This allows for performance boosts throughout ACF.
  • [Improved] relationship field: Improve querying posts / results and use AJAX powered search to increase performance on large-scale websites
  • [Improved] post object field: Improve querying posts / results

3.3.2

  • [Fixed] Integrate with Shopp plugin

3.3.1

3.3.0

  • [Fixed] Gallery not returning correct order

3.2.9

  • [Added] Add new Gallery Field
  • [Fixed] Test / Fix update_field on repeater / flexible content
  • [Fixed] Fix regex JS issue with adding nested repeaters
  • [Added] Add new Czech translation - Thanks to Webees ( http://www.webees.cz/ )

3.2.8

3.2.7

3.2.6

3.2.5

3.2.4

3.2.3

3.2.2

3.2.1

  • Field groups can now be added to options page with layout "side"
  • Fixed debug error when saving a taxonomy:
  • Fixed unnecessary code: Remove Strip Slashes on save functions
  • Added new add row buttons to the repeater field and upgraded the css / js
  • Fixed debug error caused by the WYSIWYG field: wp_tiny_mce is deprecated since version 3.3! Use wp_editor() instead.
  • Fixed duplicate field error where all sub fields became repeater fields.
  • Add Swedish translation: http://advancedcustomfields.com/support/discussion/1993/swedish-translation
  • CSS improvements
  • Fixed IE9 Bug not returning an image preview on upload / select
  • Fixed Multi export php syntax bug.

3.2.0

  • Fixed Browser bug with Flexible Field: Add Row button works again
  • Added Brazilian Translation. Thanks to Marcelo Paoli Graciano - http://www.paolidesign.com.br
  • Reverted input CSS to separate field label / instructions onto new lines.

3.1.9

  • Updated Images / JS - Please hard refresh your browser to clear your cache
  • Remove caching from acf_field_groups, replace with temp cache
  • Add "Duplicate Field" on field group edit page
  • Fix link to documentation on field group edit page
  • add "update_value" to API
  • Include new Polish translation
  • Create a nicer style for flexible content
  • Create a nicer style for repeater fields with row layout
  • Create a nicer style for "no metabox" fields
  • Add Spanish translation. Thanks to @hectorgarrofe
  • Fix css for options page no metabox
  • Added custom post_updated_messages
  • Changed "Drag and drop to reorder" from an image to a string for translation

3.1.8

  • Options page fields now save their data in the wp_options table. This will require a "Database Upgrade" when you update ACF. This upgrade will move your Options page data from the postmeta table to the options table.
  • Added _e() and __() functions to more text throughout plugin
  • Added new French translation. Thanks to Martin Vauchel @littlbr http://littleboyrunning.com
  • Fixed duplicate WYSIWYG in chrome bug
  • New Location rules: add fields to a user / taxonomy / attachment
  • Bug Fix: Color picker now shows color on page load. Thanks to Kev http://www.popcreative.co.uk
  • CSS tweaks File clearfix, new style for selects with optgroups
  • Simplified get_value to return default value if value == ""
  • API now allows for "option" and "options" for the $post_id value in API functions

3.1.7

  • Bug fix: Image field returns correct url after selecting one or more images
  • Translation: Added Polish translation. Thank you Bartosz Arendt - Digital Factory - http://www.digitalfactory.pl
  • Update : Added id attribute to all div.field (id="acf-$field_name")

3.1.6

  • New style for buttons
  • Bug Fix: Repeater maximum row setting was disabling the "add row" button 1 row early.
  • Performance: Field options are now loaded in via ajax. This results in much less HTML on the edit field group page
  • Performance: Field inputs are now loaded in via ajax. Again, less HTML on edit screens improves load times / memory usage
  • Bug Fix: Field groups registered by code were not showing on ajax change (category / page type / page template / etc). To fix this, your field group needs a unique ID. When you export a field group, you will now be given a unique ID to fix this issue. Field groups without a fixed id will still show on page load.
  • New Option: Repeater field can now have a custom button label
  • New Option: Flexible content field can now have a custom button label
  • Improvement: Updated the HTML / CSS for file fields with icon
  • Bug Fix: Fixed multi upload / select image in repeater.
  • Performance: Added caching to the get_field function. Templates will now render quicker.
  • Bug Fix: Fixed Post formats location rule - it now works.
  • Nested repeaters are now possible!

3.1.5

  • Improvement: Redesigned the experience for uploading and selecting images / files in fields and sub fields. Image / File fields within a repeater can now add multiple images / files

3.1.4

  • New Feature: Front end form (Please read documentation on website for usage)
  • Performance: compiled all field script / style into 1 .js file
  • Bug Fix: Editor now remembers mode (Visual / HTML) without causing errors when loading in HTML mode
  • Improvement: Added draft / private labels to post objects in relationship, post object and page link fields

3.1.3

  • Bug Fix: Options page fields were rendered invisible in v3.1.2 (now fixed)
  • Updated POT file with new texts

3.1.2

  • New Feature: Required field validation. Note: Repeater / Flexible content fields can be required but their sub fields can not.
  • Field update: Select field: API now returns false when "null" is selected
  • Field update: Radio button: When editing a post / page, the radio button will select the first choice if there is no saved value for the field
  • Bug fix: You can now use a repeater field inside a flexible field! Please note that the_repeater_field will not work as expected. Please use get_sub_field to get the sub repeater field, then use php to loop through it.

3.1.1

  • New Feature: Added shortcode support. usage: [acf field="field_name"]
  • Bug Fix: Fixed menu disappearing by changing the function "add_menu" to "add_utility_page"
  • Visual: Changed post object / page link fields to display post type label instead of post type name for the select optgroup label. Thanks to kevwaddell for the code

3.1.0

  • New Field: Flexible Content Field (license required)
  • Bug Fix: ACF data now saves for draft posts (please do a hard refresh on an edit screen to remove cached js)
  • Bug fix: Fixed multiple content editors

3.0.7

  • Added export / register support via PHP
  • Moved menu position under Settings
  • Improve speed / php memory by introducing cached data
  • Temp bug fix: sets content editor to "visual mode" to stop wysiwyg breaking
  • Visual: Removed "Screen Options" tab from the admin acf edit page. Added filter to always show 99 acf's
  • Minor JS improvements

3.0.6

  • Bug Fix: Location meta box now shows all pages / posts
  • Bug Fix: upgrade and settings url should now work / avoid conflicts with other plugins

3.0.5

  • Support: use wp native functions to add all user roles to location metabox
  • Update: gave acf a css update + new menu structure
  • Bug fix: fixed a few issues with wysiwyg js/css in wp3.3
  • Bug fix: fixed pagename conflicting with normal pages / posts by adding a "acf" to the page_name on save / update
  • Performance: location metabox - limited taxonomies to hierarchial only. Posts and Pages have now been limited to 25

3.0.4

  • Bug fix: WYSIWYG is now compatible with WP 3.3 (May have incidentally added support for gravity forms media button! But not 100% sure...)
  • Fix : Taxonomy Location rule now only shows hierarchal taxonomies to improve speed and reduce php memory issues

3.0.3

  • New translation: French (thanks to Netactions)
  • Support: added support for new wp3.3 editor
  • Bug fix: fixed WYSIWYG editor localised errors
  • Bug fix: removed trailing commas for ie7

3.0.2

  • New Feature: Added Export tab to export a WP native .xml file
  • New Option: Relationship / Post type - filter by taxonomy
  • New Option: default values for checkbox, select and radio
  • New Function: register_options_page - add custom options pages (Requires the option page addon)
  • Bug fix: WYSIWYG + repeater button issues
  • Bug fix: general house keeping

3.0.1

  • Bug Fix - repeater + wysiwyg delete / add duplicate id error
  • Bug fix - repeater + file - add file not working
  • Bug Fix - image / file no longer need the post type to support "editor"
  • WYSIWYG - fixed broken upload images
  • misc updates to accommodate the soon to be released "Flexible Field"

3.0.0

  • ACF doesn't use any custom tables anymore! All data is saved as post_meta!
  • Faster and more stable across different servers
  • Drag-able / order-able metaboxes
  • Fields extend from a parent object! Now you can create you own field types!
  • New location rule: Taxonomy
  • New function: register_field($class, $url);
  • New Field: Color Picker
  • New Option: Text + Textarea formatting
  • New Option: WYSIWYG Show / Hide media buttons, Full / Basic Toolbar buttons (Great for a basic wysiwyg inside a repeater for your clients)
  • Lots of bug fixes

2.1.4

  • Fixed add image tinymce error for options Page WYSIWYG
  • API: added new function: update_the_field($field_name, $value, $post_id)
  • New field: Relationship field
  • New Option for Relationship + Post Object: filter posts via meta_key and meta_value
  • Added new option: Image preview size (thumb, medium, large, full)
  • Fixed duplicate posts double value problem
  • API update: get_field($repeater) will return an array of values in order, or false (like it used to!)
  • Radio Button: added labels around values
  • Post object + Page Link: select drop down is now hierarchal
  • Input save errors fixed
  • Add 'return_id' option to get_field / get_sub_field
  • Many bug fixes

2.1.3

  • Fixed API returning true for repeater fields with no data
  • Added get_fields back into the api!
  • Fixed field type select from showing multiple repeater activation messages

2.1.2

  • Fixed repeater sortable bug on options page
  • Fixed wysiwyg image insert on options page
  • Fixed checkbox value error
  • Tidied up javascript + wysiwyg functions

2.1.1

  • Fixed Javascript bugs on edit pages

2.1.0

  • Integrate acf_values and wp_postmeta! Values are now saved as custom fields!
  • Ajax load in fields + update fields when the page / post is modified
  • API has been completely re written for better performance
  • Default Value - text / textarea
  • New upgrade database message / system
  • Separate upgrade / activate scripts
  • Select / page link / post object add Null option
  • Integrate with Duplicate Posts plugin
  • New location rule: post format
  • Repeater field attach image to post
  • Location: add children to drop down menu for page parent
  • Update script replaces image urls with their id's
  • All images / Files save as id's now, api formats the value back into a url
  • Simple CSS + JS improvements
  • New Field: Radio Buttons (please note Firefox has a current bug with jquery and radio buttons with the checked attribute)

2.0.5

  • New Feature: Import / Export
  • Bug Fixed: Wysiwyg javascript conflicts
  • Bug Fixed: Wysiwyg popups conflicting with the date picker field
  • New style for the date picker field

2.0.4

  • New Addon: Options Page (available on the plugins store: http://plugins.elliotcondon.com/shop/)
  • API: all functions now accept 'options' as a second parameter to target the options page
  • API: the_field() now implodes array's and returns as a string separated by comma's
  • Fixed Bug: Image upload should now work on post types without editor
  • Fixed Bug: Location rule now returns true if page_template is set to 'Default' and a new page is created
  • General Housekeeping

2.0.3

  • Added Option: Repeater Layout (Row / Table)
  • Fixed bug: Now you can search for media in the image / file fields
  • Added Option: Image field save format (image url / attachment id)
  • Added Option: File field save format (file url / attachment id)
  • Fixed bug: Location rules for post categories now work
  • Added rule: Page parent
  • Fixed bug: "what's new" button now shows the changelog
  • included new css style to fit in with WordPress 3.2
  • minor JS improvements

2.0.2

  • Added new database table "acf_rules"
  • Removed database table "ac_options"
  • Updated location meta box to now allow for custom location queries
  • Hid Activation Code from logged in users
  • Fixed JS bugs with wp v3.2 beta 2
  • Added new option "Field group layout" - you can now wrap your fields in a metabox!
  • General housekeeping

2.0.1

  • Added Field Option: Field Instructions
  • Added Field Option: Is field searchable? (saves field value as a normal custom field so you can use the field against wp queries)
  • Added Media Search / Pagination to Image / File thickbox
  • Added Media Upload support to post types which do not have a Content Editor.
  • Fixed "Select Image" / "Select File" text on thickbox buttons after upload
  • Repeater field now returns null if no data was added

2.0.0

  • Completely re-designed the ACF edit page
  • Added repeater field (unlocked through external purchase)
  • Fixed minor js bugs
  • Fixed PHP error handling
  • Fixed problem with update script not running
  • General js + css improvements

1.1.4

  • Fixed Image / File upload issues
  • Location now supports category names
  • Improved API - now it doesn't need any custom fields!
  • Fixed table encoding issue
  • Small CSS / Field changes to ACF edit screen

1.1.3

  • Image Field now uses WP thickbox!
  • File Field now uses WP thickbox!
  • Page Link now supports multiple select
  • All Text has been wrapped in the _e() / __() functions to support translations!
  • Small bug fixes / housekeeping
  • Added ACF_WP_Query API function

1.1.2

  • Fixed WYSIWYG API format issue
  • Fixed Page Link API format issue
  • Select / Checkbox can now contain a url in the value or label
  • Can now unselect all user types form field options
  • Updated value save / read functions
  • Lots of small bug fixes

1.1.1

  • Fixed Slashes issue on edit screens for text based fields

1.1.0

  • Lots of Field Type Bug Fixes
  • Now uses custom database tables to save and store data!
  • Lots of tidying up
  • New help button for location meta box
  • Added $post_id parameter to API functions (so you can get fields from any post / page)
  • Added support for key and value for select and checkbox field types
  • Re wrote most of the core files due to new database tables
  • Update script should copy across your old data to the new data system
  • Added True / False Field Type

1.0.5

  • New Field Type: Post Object
  • Added multiple select option to Select field type

1.0.4

  • Updated the location options. New Override Option!
  • Fixed un ticking post type problem
  • Added JS alert if field has no type

1.0.3

  • Heaps of js bug fixes
  • API will now work with looped posts
  • Date Picker returns the correct value
  • Added Post type option to Page Link Field
  • Fixed Image + File Uploads!
  • Lots of tidying up!

1.0.2

  • Bug Fix: Stopped Field Options from loosing data
  • Bug Fix: API will now work with looped posts

1.0.1

  • New Api Functions: get_fields(), get_field(), the_field()
  • New Field Type: Date Picker
  • New Field Type: File
  • Bug Fixes
  • You can now add multiple ACF's to an edit page
  • Minor CSS + JS improvements

1.0.0

  • Advanced Custom Fields.