Advanced Custom Fields PRO

Release Date 10th September 2026

• Security - ACF now validates that uploaded PDF files begin with the standard %PDF- header before further processing, rejecting files that do not match the expected format
• Security - The Relationship, Post Object, Image, Gallery, and File fields now enforce WordPress read permissions on referenced posts and attachments when returned in REST API responses
• Security - ACF now verifies both preview context and the caller's edit capability before substituting revision data when field values are retrieved for a post
• Security - The _acf_form token used by frontend forms now expires and is bound to its issuing render, and acf_encrypt() / acf_decrypt() gain an optional $context argument for domain separation between token uses
• Security - ACF now consistently runs field validation on frontend form submissions containing field data, ensuring required-field checks and custom acf/validate_value filters cannot be circumvented
• Security - ACF's REST API schema no longer discloses per-object field-group configuration in OPTIONS requests to callers who lack read permission on the target object
• Security - The User field AJAX endpoint now validates that the request nonce was created for a User field

Release Date 27th August 2026

• View Release Post
• Enhancement - ACF Blocks registered via acf_register_block_type() or block.json without an explicit version now default to v3 on WordPress 7.1 or later. Blocks that specify a version continue to use the version they declare, and the default can be customized via the acf/blocks/default_block_version filter
• Enhancement - ACF Blocks v3 now supports a renderPreview option in block.json. Setting "renderPreview": false shows a placeholder with the block's icon, title, and an "Edit Block" button in the editor instead of rendering the block's template as a live preview. The block continues to render normally on the front-end, and legacy v2 blocks combining "mode": "edit" with "supports": { "mode": false } are automatically migrated when upgraded to v3
• Fix - Inline editable fields in ACF Blocks V3 no longer require a second click before they can be edited
• Fix - Radio buttons now appear correctly in ACF admin screens
• Fix - Image and Gallery fields no longer reject SVG uploads when the Safe SVG plugin is active

Release Date 19th August 2026

• Fix - Image and Gallery fields no longer reject SVG files

Release Date 4th August 2026

• Security - ACF Image and Gallery fields now enforce server-side validation to accept only image files
• Security - The path attribute of registered ACF Blocks is now protected from being overridden by client-supplied block data
• Security - ACF's acf_encrypt() and acf_decrypt() helpers now authenticate encrypted values with an HMAC and no longer fall back to base64 encoding when OpenSSL is unavailable
• Security - ACF's comment, user, and options page form save handlers now only save values for fields whose field groups are assigned to the current save context
• Security - The Post Object, Page Link, and Relationship field AJAX search queries now enforce WordPress read permissions, preventing unauthenticated visitors from seeing non-public post statuses or post types
• Security - The User field now returns only user IDs in REST API responses to requesters without the list_users capability, preventing unauthenticated visitors from seeing user email addresses

Release Date 14th July 2026

• Fix - Google Maps field values are no longer double-encoded when saved in an ACF block
• Fix - Inserting a Link field value in the Classic Editor no longer triggers validation for other required fields before the post is saved
• Fix - Auto Inline Editing blocks no longer return truthy placeholder strings for empty field values fetched from a different post inside the block render template
• Fix - ACF Blocks (V2 and V3) no longer crash when rendering an oEmbed field whose title begins with [ or {
• Fix - Field group location rules without a location value no longer cause PHP warnings on page load
• Fix - The appearance of the URL, Number, and Select fields has been improved on WordPress 7.0+
• Fix - ACF fields now save on WooCommerce orders when using HPOS in compatibility mode

Release Date 30th June 2026

• Security - ACF PRO's save handler for WooCommerce order fields now verifies security nonces and only attaches on the order edit screen, preventing unauthenticated field value updates for stores utilizing HPOS
• Security - The Flexible Content "Rename Layout" modal no longer allows for the execution of a potential stored XSS vulnerability
• Security - A default limit of 1000 has been applied to user-contributed choices for Checkbox, Radio, and Select fields to improve security, with a new acf/fields/max_appended_choices filter available for customization
• Security - Special characters within LIKE patterns are now fully escaped in wp_options queries via $wpdb->esc_like()

Release Date 10th June 2026

• Security - ACF AJAX field handlers now validate that the request nonce was created for the expected field type
• Enhancement - ACF PRO now satisfies plugin dependencies declared against advanced-custom-fields, so plugins requiring ACF can activate when only ACF PRO is installed
• Enhancement - acf_inline_toolbar_editing_attrs() now accepts a return_array argument that returns the attributes as an escaped array suitable for use with wp_get_attachment_image()
• Fix - acf_form() with 'post_id' => 'new_post' and a fields list of field names no longer fatal errors when acf_form_head() runs before WordPress's main query is built
• Fix - Multiple acf_form() calls wrapped inside a single outer <form> tag with one submit button no longer silently drop field values, post_title, or post_content from the non-last forms
• Fix - Duplicating a V3 block with identical attributes no longer displays corrupted preview content in the duplicate
• Fix - Switching between tabs containing WYSIWYG fields no longer leaves the admin menu pinned against a shorter page, which could lock page scroll

Release Date 2nd June 2026

• Security - The oEmbed field's AJAX preview no longer performs URL discovery for users without the edit_posts capability.

Release Date 26th May 2026

• Security - ACF frontend forms (acf_form()) now respect the post_title and post_content form configuration options when processing submissions, ensuring those values are only saved when the form is configured to accept them. Thanks to Sarawut Poolkhet (MisterHelloz) for the responsible disclosure.
• Security - ACF frontend forms (acf_form()) now only save values for fields assigned to the form via the fields or field_groups parameters, or via the form's location rules

Release Date 13th May 2026

• Security - ACF now correctly checks user permissions before running database upgrades on a specific site in a multisite network
• New - A wp.data store (acf/fields) is now available in ACF PRO for reading and writing ACF field values from JavaScript, which can be enabled via a new acf/settings/enable_datastore filter (requires WordPress 6.7 or later).
• New - ACF PRO block bindings now support live preview and editing in the block editor, when both the datastore and the enable_block_bindings setting are enabled.
• New - ACF PRO can now save metabox field values via Gutenberg's native REST flow with full revision and autosave support when using the datastore.
• New - ACF PRO Blocks can now define their field group inline via an acf.fields array in block.json, or via a fields argument in acf_register_block_type(), with field keys auto-generated and scoped to the block
• Fix - Repeater and Flexible Content row helpers no longer trigger a PHP 8.x TypeError when row_index_offset or the active loop index is non-numeric
• Fix - V3 Blocks with hideFieldsInSidebar enabled no longer show fields in the sidebar after the inline toolbar popover is closed
• Fix - Scrollbars no longer appear under the tabs in field groups containing many tabs
• Fix - The acf/delete-{taxonomy} ability no longer returns a 501 error when called without an explicit force argument, as terms cannot be trashed
• Fix - The prepare_field_for_ability_import filter is now correctly removed after each Abilities field group import, preventing subsequent imports in the same request from having values corrupted

Release Date 31st March 2026 PRO Only Release

• Fix - V3 blocks with WYSIWYG fields no longer enqueue TinyMCE editor assets on the frontend
• Fix - V3 blocks with identical attributes and different InnerBlocks content no longer return cached output from the first block on the frontend

Release Date 30th March 2026

• View Release Post
• New - ACF now integrates with the WordPress Abilities API, allowing external consumers (AI tools) to manage field groups, post types, and taxonomies when explicitly enabled via the enable_acf_ai feature flag
• New - ACF can now generate JSON-LD structured data fields when explicitly enabled via the enable_schema feature flag
• New - ACF now includes WP-CLI support with new wp acf json commands for importing, exporting, syncing, and checking the status of ACF JSON files
• New - ACF custom post Types now support the WordPress 6.9+ "Notes" editor feature via a new "Notes" checkbox in the Supports settings
• Enhancement - The Blocks V3 "Open in Expanded Editor" button text can now be customized via a new acf.expandedEditorButtonText block.json property
• Enhancement - A new acf/blocks/default_expanded_editor_button_text PHP filter allows customizing the default "Open in Expanded Editor" button text for all V3 blocks
• Enhancement - The Blocks V3 edit and "Open in Expanded Editor" buttons can now be hidden via a new acf.expandedEditorButtons block.json property
• Enhancement - A new blocks/expanded_editor_overlay_class JS filter allows customizing the CSS class on the Expanded Editor modal overlay
• Enhancement - ACF Blocks V3 now preloads the block form HTML alongside the preview, eliminating an extra AJAX call on mount
• Enhancement - ACF inline script tags now use wp_print_inline_script_tag() for Content Security Policy (CSP) compliance and nonce support
• Enhancement - The Expanded Editor buttons are now hidden for V3 blocks that have no fields assigned
• Fix - Flexible Content fields now properly clean up nested postmeta when a parent layout containing nested Flexible Content fields is deleted
• Fix - The Expanded Editor "Done" button now stays disabled until the AJAX save completes, preventing data loss
• Fix - Pressing Escape while the Expanded Editor is saving will no longer close the modal, preventing data loss
• Fix - InnerBlocks content containing backslashes or dollar signs now renders correctly
• Fix - Auto Inline Editing now only applies to ACF Blocks V3, resolving incorrect hover/focus borders appearing on V2 blocks
• Fix - Validation errors in the V3 Expanded Editor no longer cause a dead-end state
• Fix - Icon Picker selections in Repeater fields no longer disappear
• Fix - Range field number input now syncs to the slider and correctly updates V3 block previews
• Fix - Message field Name and Instructions settings are no longer shown in the field group editor
• Fix - Image field no longer crashes in WordPress 7.0 release candidates
• Fix - Auto Inline Editing blocks now receive block context variables in render templates
• Fix - V3 blocks registered via PHP now correctly show the "Open in Expanded Editor" button
• Fix - Flexible Content disabled layouts now work correctly in Blocks V3
• Fix - Auto Inline Editing now works with blocks using renderCallback
• i18n - Added Danish translation

Release Date 26th March 2026

• Security - Users' unfiltered_html capability is now correctly applied to REST API calls
• Security - Block Preview rendering now correctly checks the user has permission to edit that post
• Security - Repeater fields using pagination now correctly checks the user has permissions to edit that post
• Security - Flexible content fields layout title AJAX requests now correctly verify security nonces
• Security - Clone field AJAX admin endpoints now correctly check ACF admin permissions for field group listings

Release Date 3rd March 2026

• Security - User field AJAX queries now enforce field-configured role restrictions and validate search permissions
• Security - Post Object, Relationship, and Page Link field AJAX queries now enforce field-configured restrictions for post status, post type, and taxonomy

Release Date 11th December 2025 PRO Only Release

• Fix - Posts with V3 blocks can now be saved without clicking the block

Release Date 10th December 2025 PRO Only Release

• Fix - Fields in V3 Blocks used as an InnerBlock are now clickable
• Fix - V3 Blocks with a script tag in the render template no longer crash in the editor
• Fix - V3 Blocks with Inline Editing enabled no longer crash the browser tab in some scenarios
• Fix - V3 Blocks with Inline Editing enabled used as an InnerBlock no longer update the field values of the parent block
• Fix - Quickly closing the expanded editor for V3 blocks will no longer prevent field values from being updated

Release Date 3rd December 2025

• View Release Post
• New - ACF Blocks V3 now supports Inline Editing - edit your block content directly in place, right inside the editor. Just opt in to enable it.
• Enhancement - Accordion field accessibility improvements
• Enhancement - Google Maps field accessibility improvements
• Enhancement - Styling improvements to the V3 Blocks expanded editor
• Fix - V3 ACF Blocks validation now clears properly when more than one block is in the editor.
• Fix - Relationship, Post Object, and Page Link fields now sort posts correctly on WordPress 6.8+
• Fix - List tables now respect the convert_field_name_to_lowercase javascript filter
• Fix - WYSIWYG field on attachment pages no longer sends ajax on every keystroke

Release Date 29th October 2025

• Enhancement - Added a new convert_field_name_to_lowercase JS filter to allow uppercase letters in ACF field names
• Enhancement - The form for V3 Blocks can now be optionally hidden from the sidebar via a new hideFieldsInSidebar setting in block.json
• Enhancement - V3 Blocks now display an "Open Expanded Editor" button in the sidebar for easier access to the full edit form
• Fix - The buttons to reorder ACF metaboxes are no longer hidden for metaboxes in the block editor sidebar
• Fix - V3 Blocks now display a fallback message when the block preview can't be rendered due to invalid HTML being used in field values
• Fix - V3 Blocks no longer show a loading spinner when preloaded
• Fix - V3 Blocks now save default field values even if the block wasn't interacted with before saving
• Fix - Pressing CMD/CTRL + Z no longer causes the fields to disappear in V3 Blocks
• Fix - The form for V3 Blocks now opens on the left side in RTL languages

Release Date 16th October 2025

• Fix - The Color Picker palette now displays correctly with a larger number of custom palette colors
• Fix - The WYSIWYG field no longer displays an extra textarea in ACF Blocks
• Fix - The type signature of the ACF Blocks render function now matches prior to 6.6, resolving potential type hinting errors
• Fix - V3 Blocks now correctly update the block preview when changing text controls
• Fix - V3 Blocks now work correctly in the Widget block editor
• Fix - V3 Blocks no longer render an extra hidden div into the block editor
• Fix - Fields on V3 blocks now consistently render properly when switching between “Post” and “Block” view in the sidebar

Release Date 7th October 2025

• View Release Post
• New - ACF Blocks Version 3 supports WordPress Block API Version 3
• New - ACF now requires WordPress version 6.2 or newer
• Enhancement - Field Groups can now have a separate Display Title
• Enhancement - Accessibility improvements for button groups, checkbox, radio, and image field types
• Enhancement - Color Picker field can now use a custom palette or use theme.json colors as the palette
• Enhancement - ACF admin notices now use WordPress core styles again
• Enhancement - The Flexible Content “Delete Layout” and “Rename Layout” modals now display correctly on mobile
• Fix - Blocks V3: You can now edit ACF blocks in Edit mode inside WP Core's pattern editor
• Fix - Blocks V3: Validation errors now first appear after you click "Save/publish", as opposed to immediately, while you are typing into a field for the first time
• Fix - Blocks V3: After fixing a field validation error it shows as fixed immediately as opposed to needing to click out of the block and back into it
• Fix - Blocks V3: Blocks with radio buttons no longer affect each other's field values
• Fix - Blocks V3: Blocks with required radio buttons now validate correctly
• Fix - Blocks V3: ACF field validation now works in the Site Editor
• Fix - Blocks V3: WYSIWYG fields are no longer affected by typing into other blocks
• Fix - New field names are lowercase only
• Fix - Icon Picker now enforces required validation
• Fix - Calls to jQuery’s deprecated focus function have been updated to use the trigger function
• Fix - Layouts inside cloned Flexible Content fields can now be disabled and renamed
• i18n - Updated PRO Japanese translations (props danielkun)

Release Date 10th September 2025

• Enhancement - The Flexible Content “Expand All” and “Collapse All” button now appear correctly on mobile
• Enhancement - The Flexible Content delete layout button is now back in the main layout header, making it easier to delete layouts
• Enhancement - The JSON import tool now limits the selectable files to JSON files
• Fix - Disabled Flexible Content layouts are no longer counted towards min/max layout validation
• Fix - The top “Add Row” button for layouts is now disabled when layouts have reached the max layouts validation
• Fix - The per-layout “Add Row” and “Duplicate Layout” buttons are now disabled when layouts have reached the max layouts validation
• Fix - Disabling Flexible Content layouts no longer disables layouts in cloned Flexible Content fields using a different post ID on the same page
• Fix - Flexible Content “Add Layout” menu is no longer hidden by some field types
• Fix - Flexible Content layout names can now allow some safe HTML
• Fix - When creating a temporary post type during import, ACF now correctly sets the ACF post type, rather than defaulting to post
• Fix - ACF PRO updates are now shown even when no other plugins have an update available

Release Date 12th August 2025 PRO Only Release

• Fix - Flexible Content layouts configured with a "Layout" setting of "Table" are now rendered correctly in the post editor
• Fix - Flexible Content "Add Layout" buttons now insert the new layout in the correct position
• Fix - Long Flexible Content layout names no longer extend outside of the "Add Layout" dropdown

Release Date 11th August 2025

• New - Flexible Content layouts can now be renamed in the post editor, giving content editors better clarity when managing layouts
• New - Flexible Content layouts can now be disabled, preventing them from rendering on the frontend without needing to delete their data
• New - Flexible Content layouts can now be collapsed and expanded in bulk for faster content editing
• New - Editing a Flexible Content layout now highlights the layout being edited, making it easier to identify
• New - The Date and Date Time Picker fields can now be configured to default to the current date
• Fix - Custom Icon Picker tabs now work correctly when used inside an ACF Block
• Fix - Duplicating a Field Group no longer causes a fatal error when using Russian translations
• Fix - ACF classes no longer use dynamic class properties, improving compatibility with PHP 8.2+
• Fix - ACF PRO no longer shows an update available immediately after updating to the latest version
• Fix - Field group metabox collapse and expand buttons are no longer misaligned in the post editor
• Fix - The ACF Site Health section no longer causes a PHP warning when field group location rules are incomplete
• Security - HTML is now escaped from field validation errors and tooltips

Release Date 22nd July 2025

• Security - Unsafe HTML in field group labels is now correctly escaped for conditionally loaded field groups, resolving a JS execution vulnerability in the classic editor
• Security - HTML is now escaped from field group labels when output in the ACF admin
• Security - Bidirectional and Conditional Logic Select2 elements no longer render HTML in field labels or post titles
• Security - The acf.escHtml function now uses the third party DOMPurify library to ensure all unsafe HTML is removed. A new esc_html_dompurify_config JS filter can be used to modify the default behaviour
• Security - Post titles are now correctly escaped whenever they are output by ACF code. Thanks to Shogo Kumamaru of LAC Co., Ltd. for the responsible disclosure
• Security - An admin notice is now displayed when version 3 of the Select2 library is used, as it has now been deprecated in favor of version 4

Release Date 20th May 2025

• New - In ACF PRO, fields can now be added to WooCommerce Subscriptions when using HPOS
• Security - Changing a field type no longer enables the "Allow Access to Value in Editor UI" setting
• Fix - Paginated Repeater fields no longer save duplicate values when saving to a WooCommerce Order with HPOS disabled
• Fix - Blocks registered via acf_register_block_type() with a parent value of null no longer fail to register

Release Date 8th May 2025

• New - Select fields can now be configured to allow creating new options when editing the field's value (requires the "Stylized UI" and "Multiple" field settings to be enabled)
• Enhancement - The "Escaped HTML" warning notice introduced in ACF 6.2.5 is now disabled by default
• Enhancement - The Icon Picker field now supports supplying an array of icons to a custom tab via a new acf/fields/icon_picker/{tab_name}/icons filter
• Fix - ACF Blocks are now forced into preview mode when editing a synced pattern
• Fix - The free ACF plugin once again works with the Classic Widgets plugin and the legacy ACF Options Page addon
• Fix - ACF no longer causes an infinite loop in bbPress when editing replies

Release Date 8th April 2025

• Fix - Calling acf_get_reference() with an invalid field name no longer causes a fatal error

Release Date 7th April 2025

• New - In ACF PRO, fields can now be added to WooCommerce orders when using HPOS
• Enhancement - ACF now uses Composer to autoload some classes
• Fix - Repeater pagination now works when the Repeater is inside a Group field
• Fix - Various translations are no longer called before the WordPress init action hook
• Security - Link field no longer has a minor local XSS vulnerability
• i18n - Various British English translation strings no longer have a quoting issue breaking links
• i18n - Added Dutch (formal) translations (props @toineenzo)

Release Date 21st January 2025

• Enhancement - Error messages that occur when field validation fails due an insufficient security nonce now have additional context
• Fix - Duplicated ACF blocks no longer lose their field values after the initial save when block preloading is enabled
• Fix - ACF Blocks containing complex field types now behave correctly when React StrictMode is enabled

Release Date 12th November 2024

• Enhancement - Field Group keys are now copyable on click
• Fix - Repeater tables with fields hidden by conditional logic now render correctly
• Fix - ACF Blocks now behave correctly in React StrictMode
• Fix - Edit mode is no longer available to ACF Blocks with an WordPress Block API version of 3 as field editing is not supported in the iframe

Release Date 29th October 2024 Free Only Release

• Fix - ACF Free no longer causes a fatal error when any unsupported legacy ACF addons are active

Release Date 29th October 2024 Free Only Release

• Fix - ACF Free no longer causes a fatal error when WPML is active

Release Date 29th October 2024

• Security - Setting a metabox callback for custom post types and taxonomies now requires being an admin, or super admin for multisite installs
• Security - Field specific ACF nonces are now prefixed, resolving an issue where third party nonces could be treated as valid for AJAX calls
• Enhancement - A new “Close and Add Field” option is now available when editing a field group, inserting a new field inline after the field being edited
• Enhancement - ACF and ACF PRO now share the same plugin updater for improved reliability and performance
• Fix - Exporting post types and taxonomies containing metabox callbacks now correctly exports the user defined callback

Release Date 15th October 2024

• Security - Editing an ACF Field in the Field Group editor can no longer execute a stored XSS vulnerability. Thanks to Duc Luong Tran (janlele91) from Viettel Cyber Security for the responsible disclosure
• Security - Post Type and Taxonomy metabox callbacks no longer have access to any superglobal values, hardening the original fix from 6.3.8 further
• Fix - ACF fields now correctly validate when used in the block editor and attached to the sidebar

Release Date 7th October 2024

• Security - ACF defined Post Type and Taxonomy metabox callbacks no longer have access to $_POST data. (Thanks to the Automattic Security Team for the disclosure)

Release Date 2nd October 2024

• Security - ACF Free now uses its own update mechanism from WP Engine servers

Release Date 28th August 2024

• Security - Newly added fields now have to be explicitly set to allow access in the content editor (when using the ACF shortcode or Block Bindings) to increase the security around field permissions. See the release notes for more details
• Security Fix - Field labels are now correctly escaped when rendered in the Field Group editor, to prevent a potential XSS issue. Thanks to Ryo Sotoyama of Mitsui Bussan Secure Directions, Inc. for the responsible disclosure
• Fix - Validation and Block AJAX requests nonces will no longer be overridden by third party plugins
• Fix - Detection of third party select2 libraries will now default to v4 rather than v3
• Fix - Block previews will now display an error if the render template PHP file is not found

Release Date 1st August 2024

• Fix - The ACF Shortcode now correctly outputs a comma separated list of values for arrays
• Fix - ACF Blocks rendered in auto mode now correctly re-render their previews after editing fields
• Fix - ACF Block validation no longer raises required validation messages if HTML will automatically select the first value when rendered
• Fix - ACF Block validation no longer raises required validation messages if a default value will be rendered as the field value
• Fix - ACF Block validation no longer raises required validation messages for fields hidden by conditional logic when adding a new block

Release Date 18th July 2024

• Security Fix - The ACF shortcode now prevents access to fields from different private posts by default. View the release notes for more information
• Fix - Users without the edit_posts capability but with custom capabilities for a editing a custom post type, can now correctly load field groups loaded via conditional location rules
• Fix - Block validation no longer validates a field’s sub fields on page load, only on edit. This resolves inconsistent validation errors on page load or when first adding a block
• Fix - Deactivating an ACF PRO license will now remove the license key even if the server call fails
• Fix - Field types returning objects no longer cause PHP warnings and errors when output via the_field, the_sub_field or the ACF shortcode, or when retrieved by a get_ function with the escape html parameter set
• Fix - Server side errors during block rendering now gracefully displays an error to the editor

Release Date 27th June 2024

• Enhancement - All dashicons are now available to the icon picker field type
• Fix - The True/False field now correctly shows it’s description message beside the switch when using the Stylized UI setting
• Fix - Conditional logic values now correctly load options when loaded over AJAX
• Fix - ACF PRO will no longer trigger license validation calls when loading a front-end page
• i18n - Fixed an untranslatable string on Option Page previews

Release Date 24th June 2024 PRO Only Release

• Fix - ACF Blocks no longer trigger a JavaScript error when fetched via AJAX

Release Date 24th June 2024

• Security Fix - ACF now generates different nonces for each AJAX-enabled field, preventing subscribers or front-end form users from querying other field results
• Security Fix - ACF now correctly verifies permissions for certain editor only actions, preventing subscribers performing those actions
• Security Fix - Deprecated a legacy private internal field type (output) to prevent it being able to output unsafe HTML
• Security Fix - Improved handling of some SQL filters and other internal functions to ensure output is always correctly escaped
• Security Fix - ACF now includes blank index.php files in all folders to prevent directory listing of ACF plugin folders for incorrectly configured web servers

Release Date 6th June 2024 PRO Only Release

• Fix - ACF Blocks in widget areas no longer cause a fatal error when no context is available
• Fix - ACF Blocks with no fields assigned no longer show a gap in the sidebar where the form would render

Release Date 6th June 2024 PRO Only Release

• Fix - Repeater and Flexible Content fields no longer error when duplicating or removing rows containing Icon Picker subfields
• Fix - ACF Blocks containing Flexible Content fields now correctly load their edit form
• Fix - ACF Blocks no longer have a race condition where the data store is not initialized when read
• Fix - ACF Blocks no longer trigger a JS error for blocks without fields and with an empty no-fields message
• Fix - ACF Block preloading now works correctly for fields consuming custom block context
• Fix - ACF Block JavaScript debug messages now correctly appear when SCRIPT_DEBUG is true

Release Date 4th June 2024

• Enhancement - Options Pages registered in the UI can now be duplicated
• Fix - ACF Block validation now correctly validates Repeater, Group, and Flexible Content fields
• Fix - ACF Block validation now correctly validates when a field is using a non-default return type
• Fix - Fields moved between field groups now correctly updates both JSON files
• Fix - Icon Picker fields now render correctly when using left-aligned labels
• Fix - Icon Picker fields no longer renders tabs if only one tab is selected for display
• Fix - Icon Picker fields no longer crash the post editor if no icon picker tabs are selected for displayed
• Fix - True/False field now better handles longer On/Off labels
• Fix - Select2 results loaded by AJAX for multi-select Taxonomy fields no longer double encode HTML entities

Release Date 22nd May 2024

• Fix - A possible fatal error no longer occurs in the new site health functionality for ACF PRO users
• Fix - A possible undefined index error no longer occurs in ACF Blocks for ACF PRO users

Release Date 22nd May 2024

• New - ACF now requires WordPress version 6.0 or newer, and PHP 7.4 or newer.
• New - ACF Blocks now support validation rules for fields. View the release notes for more information
• New - ACF Blocks now supports storing field data in the postmeta table rather than in the post content
• New - Conditional logic rules for fields now support selecting specific values for post objects, page links, taxonomies, relationships and users rather than having to enter the ID
• New - New Icon Picker field type for ACF and ACF PRO
• New - Icon selection for a custom post type menu icon
• New - Icon selection for an options page menu icon
• New - ACF now surfaces debug and status information in the WordPress Site Health area
• New - The escaped html notice can now be permanently dismissed
• Enhancement - Tab field now supports a selected attribute to specify which should be selected by default, and support class attributes
• Fix - Block Preloading now works reliably in WordPress 6.5 or newer
• Fix - Select2 results loaded by AJAX for post object fields no longer double encode HTML entities
• Fix - Custom post types registered with ACF will now have custom field support enabled by default to better support revisions
• Fix - The first preview after publishing a post in the classic editor now displays ACF fields correctly
• Fix - ACF fields and Flexible Content layouts are now correctly positioned while dragging
• Fix - Copying the title of a field inside a Flexible Content layout no longer adds whitespace to the copied value
• Fix - Flexible Content layout names are no longer converted to lowercase when edited
• Fix - ACF Blocks with attributes without a default now correctly register
• Fix - User fields no longer trigger a 404 when loading results if the nonce generated only contains numbers
• Fix - Description fields for ACF items now support being solely numeric characters
• Fix - The field group header no longer appears above the WordPress admin menu on small screens
• Fix - The acf/json/save_file_name filter now correctly applies when deleting JSON files
• i18n - All errors raised during ACF PRO license or update checks are now translatable
• Other - The ACF Shortcode is now disabled by default for new installations of ACF as discussed in the ACF 6.2.7 release notes

Release Date 15th May 2024

• Security Fix - ACF Blocks no longer allow render templates, or render or asset callbacks to be overridden in the block's attributes. For full information, please read the release blog post

Release Date 8th April 2024

• Enhancement - The Select2 escapeMarkup function can now be overridden when initializing a custom Select2
• Fix - “Hide on Screen” settings are now correctly applied when using conditionally loaded field groups
• Fix - Field names are no longer converted to lowercase when editing the name
• Fix - Field group titles will no longer convert HTML entities into their encoded form

Release Date 2nd April 2024

• New - Support for the Block Bindings API in WordPress 6.5 with a new acf/field source. For more information on how to use this, please read the release blog post
• New - Support for performance improvements for translations in WordPress 6.5
• Enhancement - A new JS filter, select2_escape_markup now allows fields to customize select2's HTML escaping behavior
• Fix - Options pages can no longer set to have a parent of themselves
• Fix - ACF PRO license activations on multisite subsite installs will now use the correct site URL
• Fix - ACF PRO installed on multisite installs will no longer try to check for updates resulting in 404 errors when the updates page is not visible
• Fix - ACF JSON no longer produces warnings on Windows servers when no ACF JSON folder is found
• Fix - Field and layout names can now contain valid non-ASCII characters
• Other - ACF PRO now requires a valid license to be activated in order to use PRO features. Learn more

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

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

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

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.

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

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

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

Release Date 8th September 2023

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

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

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)

View the full changelog

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)

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

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

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)

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

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

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

Release Date 3rd April 2023

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

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

Release Date 16th March 2023

• View Release Post
• New - Custom Post Type and Taxonomy registration support via the ACF Admin UI. 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
• 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 via the custom_choice_button_text property
• Fix - ACF Block field edit view buttons now work correctly inside reusable blocks

Release Date 18th January 2023

• Improvement - Removed unnecessary “Layout” prefix 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

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

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)

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

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

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

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

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)

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)

Release Date 3rd 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

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

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.)

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

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!)

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

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

Release Date - 24th November 2021

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

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

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

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

View the full changelog

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

Release Date - 26 August 2021

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

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

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

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

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

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

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

Release Date - 12 May 2020

• See hotfix version 5.8.11 for release notes.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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

View the full changelog