Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Backups & maintenance · Guide

How to Update Advanced Custom Fields Pro (Step by Step)

How to Update Advanced Custom Fields Pro (Step by Step)

Short answer

Activate your ACF PRO licence key under ACF, Updates in wp-admin, then update the plugin from Dashboard, Updates or the Plugins screen. Without an active licence, download the latest zip from your ACF account and upload it with Plugins, Add New, Upload Plugin, choosing to replace the current version.

Key takeaways

  • ACF PRO updates come from ACF servers, not WordPress.org.
  • An active licence key is needed for one-click updates.
  • You can store the key in wp-config.php as a constant.
  • Uploading the new zip and replacing the old one keeps your data.
  • Back up and test templates after every major update.

How do you update Advanced Custom Fields Pro?

Activate your ACF PRO licence key inside WordPress, then update it from the Plugins or Updates screen like any other plugin.

ACF PRO is not hosted in the WordPress.org directory. It receives updates from the Advanced Custom Fields servers, and those updates only reach your site when a valid licence is active.

If the licence is missing or expired, WordPress will not offer a one-click update. In that case you can still update manually by uploading a fresh zip from your ACF account.

This guide covers both methods, plus what to check before and after.

Why doesn't ACF PRO update like free plugins?

Free plugins update through WordPress.org, while ACF PRO checks its own licence server, so no licence means no automatic update notice.

The free Advanced Custom Fields plugin lives on WordPress.org. PRO is sold on the ACF PRO page and adds features such as repeater, flexible content, gallery and options pages.

Because PRO is a commercial plugin, the update package is delivered only to sites with an active licence.

That is also why a PRO site can look up to date even when it is not. WordPress simply does not know a newer version exists.

To see which version you run, open Plugins > Installed Plugins and read the version number under Advanced Custom Fields PRO. Compare it with the latest release listed in your ACF account or on the ACF Updates screen.

Also make sure you are not running the free plugin and PRO at the same time. PRO includes everything in the free version, so keeping both active is unnecessary and can cause confusion during updates.

What should you do before updating?

Take a full backup, check that your PHP and WordPress versions meet the new release requirements, and ideally test the update on a staging copy first.

ACF controls how your custom data is displayed. A bad update rarely deletes data, but it can break templates that call ACF functions.

Use this short checklist:

How do you activate your ACF PRO licence?

Open the ACF Updates screen in wp-admin, paste the licence key from your ACF account, and click the activate button.

  1. Log in to your account on the ACF website and copy your licence key.
  2. In wp-admin, go to ACF > Updates (older versions label the menu Custom Fields > Updates).
  3. Paste the key into the licence field.
  4. Click Activate License.

The screen should then show that the licence is active and list the latest available version.

Each licence has a limit on how many sites can be activated. If you hit that limit, deactivate the licence on an old or deleted site from your ACF account, then try again.

Can you store the licence key in wp-config.php?

Yes, ACF PRO supports defining the licence key as a constant in wp-config.php, which is useful for agencies and sites deployed from code.

Add a line like this above the That's all, stop editing comment:

define( 'ACF_PRO_LICENSE', 'your-licence-key-here' );

The wp-config.php documentation explains where the file lives and how constants work.

If you are not sure where the file is, read where to find wp-config.php in WordPress.

Treat the key like a password. Do not commit it to a public repository.

The constant is handy on staging and local copies too. When the same wp-config.php setup is used across environments, the licence travels with the site and updates keep working after a deploy.

Remember that each environment may count toward your activation limit, depending on the licence terms. Check your account if activations run out.

How do you update ACF PRO from the dashboard?

Once the licence is active, go to Dashboard, then Updates, or to the Plugins screen, and click update now next to Advanced Custom Fields PRO.

  1. Go to Dashboard > Updates and click Check Again if no update shows yet.
  2. Tick Advanced Custom Fields PRO in the plugin list.
  3. Click Update Plugins.

Or update from Plugins > Installed Plugins by clicking update now under the plugin name.

You can also enable auto-updates from the Plugins screen. For a plugin that controls templates, many developers prefer to update by hand so they can check the site straight away.

For general update habits, see how to update plugins in WordPress.

How do you update ACF PRO manually with a zip file?

Download the latest PRO zip from your ACF account, then upload it through Plugins, Add New, Upload Plugin and choose to replace the current version.

  1. Log in to your ACF account and download the latest ACF PRO zip.
  2. In wp-admin, go to Plugins > Add New Plugin > Upload Plugin.
  3. Choose the zip and click Install Now.
  4. WordPress detects the existing plugin and shows a comparison. Click Replace current with uploaded.

WordPress keeps your field groups and data, because they live in the database, not in the plugin folder.

The WordPress.org guide to managing plugins covers the upload screen in more detail.

If the upload fails, you can replace the plugin folder by FTP. Delete the old advanced-custom-fields-pro folder only after you have the new one ready, then upload the new folder to wp-content/plugins/.

What do the update methods look like side by side?

The dashboard update is fastest, the zip upload works without a working licence connection, and FTP is the fallback when uploads fail.

MethodNeeds active licenceSpeedBest for
Dashboard updateYesFastestMost sites
Upload zip and replaceNo, but you need account accessQuickLicence connection issues
FTP folder swapNo, but you need account accessSlowerUpload limits or a locked dashboard
ComposerYesFast in deploy pipelinesDeveloper workflows

Developers who manage sites with Composer can pull ACF PRO from ACF's own package source. Check the developer resources on the ACF site for the current setup.

What should you check after updating?

Open the ACF field groups screen, run any database upgrade it asks for, and check pages that display custom fields on the front end.

Major ACF releases sometimes ask to upgrade the database. If you see that notice, run it after confirming your backup.

Then check:

  • Pages that use repeater or flexible content fields.
  • Options pages and any global header or footer fields.
  • Blocks registered with ACF, if your theme uses them.
  • The PHP error log, if anything looks wrong.

If a page breaks, restore the previous version from your backup and report the issue on the ACF support channels.

What if the update says the licence is invalid or expired?

An expired or deactivated licence stops update delivery, so renew it in your ACF account or re-enter the correct key on the Updates screen.

Common causes include a key copied with spaces, a site URL that changed after migration, or reaching the site activation limit.

After moving a site to a new domain, deactivate and reactivate the licence so the server records the new URL.

If you no longer want to pay for PRO, check whether your site actually uses PRO fields. The basics are covered in how to use Advanced Custom Fields.

Is it safe to stay on an old ACF PRO version?

Staying on an old version is risky, because security and compatibility fixes only arrive through updates, and new WordPress or PHP versions may break older code.

If renewing is not possible right now, keep the rest of the site updated and plan a renewal or migration soon.

A plugin that renders user data on every page deserves current security fixes.

If you inherited a site and do not know who owns the licence, ask the previous developer or agency. Licences are tied to an ACF account, and the account owner can transfer, renew or deactivate sites.

For client work, it is usually best for the client to own the licence. That way updates keep working even if the agency relationship ends.

Frequently asked questions

Why is there no update notice for ACF PRO?

ACF PRO only shows updates when a valid licence key is active on the site. Enter or renew the key on the ACF Updates screen, then click Check Again on the Dashboard Updates page.

Will updating ACF PRO delete my custom fields?

No. Field groups and field values are stored in the database, not in the plugin files. Updating replaces the code only. Still, take a backup first in case a template needs fixing afterwards.

Can I update ACF PRO without a licence?

Only if you can download the new zip from an ACF account that has access to that version. Without access, you cannot legitimately get newer PRO releases, so renew the licence instead.

Where do I find my ACF PRO licence key?

Log in to your account on the Advanced Custom Fields website. The licence key is listed with your subscription details, where you can also see and manage activated sites.

Should I turn on auto-updates for ACF PRO?

It depends on the site. Auto-updates keep security fixes flowing, but a plugin that controls templates can break layouts. Busy sites often update manually after testing on staging.

Sources

  1. ACF PRO Advanced Custom Fields
  2. Advanced Custom Fields WordPress.org Plugins
  3. Manage Plugins WordPress.org Documentation
  4. wp-config.php WordPress Developer Resources
  5. Supported Versions PHP

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.