Advanced Custom Fields pro 3.1.5

Advanced Custom Fields 3.1.5​

Released on Monday, 06 July 2026 12:02
Maturity: Stable

Release Notes​

Read the detailed notes about this release, including new features, improvements, and bug fixes.

Security

• Security: Fix arbitrary file copy/overwrite in Gallery field image regeneration.
• Security: Fixed obsolete framework files not being removed during updates.

Added

• Added support for importing and exporting marker title and description in the Map field.
• Added support for reading Video field start/end times from the video URL, overriding global settings for YouTube, Vimeo, and Dailymotion.
• Added a warning in the Gallery field settings when the PHP "fileinfo" extension is missing.
• Added a searchable dropdown to the Download Button field's file selector.

Fixed

• Fixed File Upload field not deleting the physical file when removed from within a Subform field.
• Fixed Gallery field failing to upload images when the site's temporary folder is located outside the web root.
• Fixed File Upload field "Randomize File Names" setting ignored.
• Fixed File Upload field now shows a clear error when an uploaded file cannot be moved to a non-writable or invalid upload folder, instead of failing silently.
• Fixed Map field API keys documentation links.

Changed

• Updated Video field's "Related Videos" description. It can now show related videos from any channel or from current channel.

Compatibility​

Your site should meet the following requirements to be able to install this release.

Joomla
4.0 4.1 4.2 4.3 4.4 5.0 5.1 5.2 5.3 5.4 6.0 6.1
PHP
7.4 8.0 8.1 8.2 8.3 8.4

Security

• Security: Fixed a critical arbitrary file deletion vulnerability in the File Upload field.

Fixed

• Fixed Phone Number field country selector not allowing selection in Joomla 6.1.
• Fixed FAQ field validation not triggering when the field is required but left empty.
• Fixed Chained Fields displaying a MIME Types warning despite having a valid configuration.
• Fixed Map field not rendering in YooTheme Dynamic Content when Max Markers is set to 1.

v3.1.3
Added

• Joomla ACL support in Articles field.

Fixed

• File Upload actions not appearing on hover over uploaded items.

v3.1.2
Fixed

• File Upload Field keeps asking for a file when set as required, even after one has already been uploaded.

v3.1.1
Added

• Patched a security vulnerability and strengthened data validation and sanitization.
• Support for custom ACF IFrame title attribute using the "URL|title" field value format.
• Support for Facebook Reels in ACF Video.
• Smart Tag {this.filename} for use in the ACF Download Button field > Button Label, returning the selected file name.
• Subform support for ACF Articles.
• Support for "webp, stp, step, igs, iges" file types in File Upload Field.

Fixed

• Compatibility with YooTheme 5.0.0 BETA.
• ACF Articles Status Input Filter not respecting its value in certain cases.
• ACF Gallery preventing uploads when the Gallery Files Limit was set to a single file.
• ACF Gallery not outputting alt text when images opened in the lightbox.
• Some HTML attributes stripped when editing content in TinyMCE editor.
• ACF URL "target" setting not return a valid value in YooTheme.
• Error “Call to a member function get() on array” could appear in rare cases when using ACF fields inside a Subform field.
• Video custom field to correctly load external URLs, including self-hosted video files (mp4, mov, ogg, webm).
• QR Code custom field not allowing VCARD syntax to be entered correctly.

Changed

• Updates File Upload Field with built-in image previews.
• Changed ACF Articles Author Input Filter to return all users.
• Changed ACF Chained Fields to use the Media Manager for CSV file selection.

* [View Release Post](https://www.advancedcustomfields.com/blog/acf-pro-6-8-release-ai-ready-discoverable-content/)
* 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

Added

• Joomla 6 Native Support.
• Loading spinner for the ACF Address Autocomplete field when searching for an address to provide user feedback.
• Support for fullscreen option in ACF Video with Vimeo provider.

Fixed

• ACF Video not supporting YouTube live videos.
• ACF Video not previewing videos when Facebook provider is selected.
• ACF Address Autocomplete Field map editor where the marker couldn’t be moved or the map cleared.
• ACF Gallery and ACF File Upload Fields not working correctly inside nested Subform fields.
• ACF Articles field where some tags wouldn't be shown in the dropdown.
• ACF Gallery failing to upload images from the Media > Path to Files Folder.
• ACF Map Editor becoming unresponsive when confirming a dialog outside the map and the “Add Marker” menu not toggling correctly.
• ACF Address Autocomplete not saving when the map was disabled, the field was required, and the address was correctly set.
• FAQ Field "Duplicate field FAQPage" error in Google Rich Results Tool.
• ACF FAQ editors not loading properly in Categories when the default editor was set to JCE.

Changed

• Improved ACF Gallery media manager selection.

Added

• "Initial Zoom Level" option in Map Field for better map customization.
• "House Number" to Address Autocomplete for more precise addresses.

Fixed

• Articles field PHP error that could occur when saving certain articles.
• Articles field filter by Author leaving “Loading more results” visible.
• Gallery Field issue preventing image selection from Media Library in list view.
• Map Field crash when moving a temporary marker in the editor.

Changed

• Removed "Select a country" from Country Field when Multiple Country Selection is enabled.
• Improved Articles field to show article ID in dropdown for easier selection.

Added

Display Conditions support to category custom fields.
Chained Field data source now supports commas when enclosed in quotation mark

Fixed

Telephone Field input mask issue inside subform field.
Telephone Field input mask issue in YooTheme.
Articles field categories filter would be applied despite being disabled.
Articles field ordering issue in YooTheme.
Articles field error when used with the Joomla API.
Unusable editor in FAQ Field after reordering items.

Changed

Improved Country Field with Multiple Item Selection when used in YooTheme.
Changed Video Field default height to "auto".
Sets minimum required Joomla! version to 4.0.
Sets minimum required PHP version to 7.4.

Fixed

• Improves CSRF token handling in the File Upload Field.
• "google.maps.Marker is deprecated" notice in Map custom field.
• ACF Articles Automatic Discovery not enabled by default on new articles when Default Value is set.
• Incorrect error message when the uploaded file does not exist in the File Upload Field.

Changed

• Updated ACF File Upload to use the file name as the title when the title is missing.

Added

• Easier selection of countries in Country custom field for both single and multiple values.
• Auto responsiveness to Video custom field when no height is set.

Fixed

• Inaccurate marker address may be displayed in Map custom field.
• File Upload Field appearing in DPCalendar Filters.

Changed

• Replaced full URLs with relative URLs in YooTheme Pro for Gallery & File Upload Fields.

Added

• Support for Krita (.kra and .krz) files in File Upload Field.
• "File Size" option in File Upload Field for YooTheme Integration.
• Support for YouTube Shorts in Video Field.
• Shortcode support in Map Field marker descriptions.

Fixed

• Articles field not displaying the hint when Maximum Articles is set to 1.
• Gallery Field issue with Slideshow provider when Lightbox is enabled and a module is selected.
• Gravatar Field "ACFGravatarValidator not found" error on save.
• Video Field warning during installation process.

Changed

• Removed double slash from Gallery Image URLs in YooTheme Integration.
• Removed extra image element overlaying preview in Gallery Field editor.