Upgrading ACF to version 5 is simple, here's how.
Log into your WordPress website and use the Plugins page to view and update the Advanced Custom Fields plugin.
Does this website use the Repeater field, Flexible Content field, Gallery field or Options Page add-ons? Be sure to update these too.
Version 5 uses a much smarter way to organise field groups and will need to create some extra data before it is ready for use.
Nice work, you are now updated! Be sure to take a quick look over your website to ensure everything is as it should be and don't hesitate to contact our support team with any questions or concerns.
We made some changes. Here are the ones you should know about.
|ACF PRO||We've moved away from selling individual add-ons towards an all inclusive PRO version! This pro version bundles together ACF + 5 features into 1 easy to access plugin! Changing to this new platform allows us to do 2 important things; Firstly, to provide more updates & features from our end, and secondly, to reduce the time time & effort needed to maintain the ACF plugins from your end.|
|Add-ons||We don't want to leave any of our amazing customers worried about past projects, and this is why we have released updates for all ACF Add-ons making them fully compatible with ACF version 5!|
|Database Upgrade||After updating to ACF version 5, you will be prompted to upgrade the Database. This is a necessary step to migrate field group settings over to their new location (discussed in 'Field Groups' notes). This upgrade will also copy across any taxonomy term values from the 'wp_options' table to the newly used 'wp_termmeta' table! Please note this upgrade will not delete or remove any data.|
|Template Functions||No changes to report here. You can expect every
|Field Groups||Field group settings are now saved with a post_type of 'acf-field-group' (previously 'acf'). New settings have also been added including active, label_placement, instructions_placement and description.|
|Fields||Field settings are now also saved to the wp_posts table with a post type of 'acf-field'. Many new settings have been added to each field type!|
|wp_termmeta||Taxonomy term custom field values are now saved to the 'wp_termmeta' table! These values were previously saved to the wp_options table. The database upgrade will also copy across all term custom field values to the wp_termmeta table.|
|select2||ACF version 5 includes the Select2 JS library for powerful AJAX based selection in many of it's field's (select, post_type, taxonomy, user)!|
|Admin HTML||The markup for fields has changed to use an 'acf-' prefix on classes. In the interest of backwards compatibility, ACF version 5 will add the 'previous' field class names if ACF version 4 has previously been installed.|
|$_POST||Field values will now be sent in the $_POST data using
|Export||ACF version 5 includes a .json based export and import tool. Previous version of ACF used the WP .xml export which will no longer be compatible.|
Have questions? We have answers.
Please be aware that ACF version 5 is currently undergoing beta testing and will not be released as a 'one-click' update until later this year. If you wish to download and install the version 5 manually, please see the Beta Test - Version 5 guide.
No, you do not need to make any changes to your theme. ACF version 5 is still the same plugin you use and love, and will work in the same way. If your theme contains heavy ACF customisation, it will be wise to review your code and check for any issues.
Yes, we have released updates for all official ACF Add-ons (Repeater, Gallery, Flexible Content & Options Page) making them fully compatible with ACF version 5! Please update your ACF add-ons to version 2.
No, ACF version 5 is a free update. If you require professional features such as the repeater field, please take a look at the ACF PRO page here.
Yes, although it is a manual process. All versions of the ACF plugin can be found here. Simply download, extract and replace your 'plugins/advanced-custom-fields' plugin folder
It is always a good idea to backup your website before updating a plugin to a new major version, however, this is not required. ACF version 5 does not delete or modify any existing data during the 'DB Upgrade' - only new data is created.