Install, update & activate
Install Free, connect Pro and manage updates or a development copy.
On this page
Choose your starting point
- New to CustomFields? Install and activate Free first. Follow your first field to confirm it works.
- Adding Pro? Keep Free active, install the separate add-on from your account, then connect your licence in Help & updates → Licence & updates.
- Updating an existing site? Follow the upgrade precautions below. Do not uninstall either edition to update it.
Install or upgrade
Back up your site and test the update on staging. Finish or pause active imports, deployments, bulk jobs and background requests before replacing files. Update Free from WordPress.org without uninstalling. If a Pro update is available in your account, replace that add-on in a separate request after Free. Current account downloads include matching Free and Pro 1.2.5 packages. WordPress.org follows its separate publication schedule. Check your content and Pro workflows before resuming paused work.
For a fresh installation, activate Free from WordPress.org first. If you purchased Pro, get the add-on from your eligible account and check its requirements before activation. The minimum requirements remain WordPress 6.5 and PHP 7.4. If you still use the legacy customfields Free folder, install the customfields-com package, deactivate the old Free copy and activate CustomFields.com; leave the old copy inactive and do not uninstall it during this move.
Site-options saves and protected migration workflows require MySQL or MariaDB with InnoDB tables. Migrations also require advisory-lock support. SQLite is not supported for these operations.
Activate Pro on this site
Free needs no account or licence. To use Pro tools, install the Pro add-on from your eligible account, then open CustomFields → Licence & updates. Enter the connection key from your account, review the displayed service destination and data disclosure, and explicitly connect the site. A valid activation unlocks Pro on this site. New Pro licence activation supports single-site WordPress. Existing confirmed per-site multisite connections retain activation; new multisite licence activation is not available in this release. Each additional production site needs its own activation within your plan; use the development-copy process for an eligible staging site.
After a valid activation, local Pro tools keep working if the service is temporarily unavailable or update and support access expires. Pro update checks remain a separate opt-in choice, and WordPress controls automatic installation. Choosing Disconnect locks new Pro operations and pauses background work without deleting saved content, definitions or workflow records. Activate again before using Pro tools, then explicitly resume any approved background work you want to continue. Disconnect does not cancel annual renewal.
Link a development copy
Each production connection can include one copy. Create a 10-minute proof in the connected production site’s Licence & updates screen. In Account, enter the proof, exact copy URL and explicit non-production declaration. Connect the copy with its 15-minute single-use key and separate service consent. Supported HTTPS hosts are exactly staging., dev. or test. followed by the full production hostname, with the same port and WordPress path. Other addresses need a production slot. This proves possession of the connection, not DNS control or intended use. Reconnecting/disconnecting the parent or rotating its account key also revokes its copy and pending keys.
Workspace and welcome choices
The first individual Free activation opens the focused CustomFields workspace. Use Back to WordPress to return; the workspace remembers your display choice. After a meaningful save, optional domain sharing and email signup are offered separately. Both start unchecked. You can skip them or revisit Help & updates → Welcome choices.
Read the data and withdrawal details. Free Pro-preview screens use sample data. A selected workflow may be remembered locally for seven days; after activating Pro, review its real state before applying changes.
Free fields. Pro interactive workflows.
Free includes all 26 field types, repeaters, field creation and storage, WordPress-admin editing, basic display, named blocks, normal WordPress search and developer APIs. Pro supplies the visual directory/listing builder, configurable listing layouts and queries, reader search and frontend edit/create forms.
Deactivating Pro keeps definitions and stored values. Existing saved listings continue rendering, and WordPress-admin editing remains Free. Creating or changing listing definitions and supplied frontend workflows requires activated Pro. Public Pro submissions enter a private review queue; they do not grant anonymous editing.