Title: Esumo Field Renamer for ACF Author: Esumo Published: September 13, 2026 Last modified: September 13, 2026 --- Search plugins ![](https://ps.w.org/esumo-field-renamer-for-acf/assets/icon-256x256.png?rev=3694274) # Esumo Field Renamer for ACF By [Esumo](https://profiles.wordpress.org/jayfromesumo/) [Download](https://downloads.wordpress.org/plugin/esumo-field-renamer-for-acf.1.0.zip) * [Details](https://wordpress.org/plugins/esumo-field-renamer-for-acf/#description) * [Reviews](https://wordpress.org/plugins/esumo-field-renamer-for-acf/#reviews) * [Installation](https://wordpress.org/plugins/esumo-field-renamer-for-acf/#installation) * [Development](https://wordpress.org/plugins/esumo-field-renamer-for-acf/#developers) [Support](https://wordpress.org/support/plugin/esumo-field-renamer-for-acf/) ## Description Renaming a field in Advanced Custom Fields changes its definition, but values already saved on posts can remain under the previous metadata name. Esumo Field Renamer for ACF supports both before and after renaming, preserving the field key, raw values and metadata row IDs. It is a free developer tool with no account, license key, telemetry or external service. **Workflow** 1. Test on a copy of your site, keep a full database backup and pause content editing. 2. Open Tools > Field Renamer and choose Before renaming or After renaming. 3. Select the field and enter its new name (Before) or previous name (After). 4. Prepare a preview. Resolve any conflicts before starting a new preview. 5. Optionally preview theme references, review every difference, and apply only checked files. 6. Rename the field and migrate values (Before), or migrate values (After). Verify the affected pages and remaining code references. Before renaming supports native database definitions managed in the ACF editor. It changes only the field-name column and preserves the other field settings. PHP and Local JSON definitions must be renamed in their source first, then migrated with After renaming. Recent operations has its own tab; opening an operation there returns to its details. When a field is renamed through the ACF field editor, the plugin records a suggestion for its previous name. Data migration always requires an explicit action. **Supported in 1.0** Top-level Text, Textarea, Number, Email and URL fields in active field groups explicitly assigned to posts, pages or custom post types. Data belonging to a different ACF field key is skipped. Ambiguous references and occupied destination names block migration, including empty destination values. Nested fields, Repeater, Group, Flexible Content, Clone, ACF Blocks, Options Pages, attachments, revisions, users, terms and multisite are outside this version. The plugin does not edit definitions in PHP/JSON, dynamic names, JavaScript, Twig or meta queries. Test compatibility with any additional ACF extensions. **Optional theme references** Review literal first arguments of get_field(), the_field(), get_field_object(), update_field() and delete_field() in PHP files of the active theme and its parent. Check each file before applying it. Calls use field names, so review their context if multiple field groups share a name. Dynamic, named and namespaced calls need manual review. Symbolic links, vendor and node_modules are excluded. Limits: 2,000 PHP files scanned, 512 KB per file, 50 matching files, and 2 MB of combined before/after content. Writes require edit_themes permission, allowed file modifications and direct filesystem access. Pause deployments and file edits during the operation. Files are restored separately from database changes. Hash checks refuse later edits, and saved file copies allow recovery after a lost response. The preview checks write access to both the file and its directory. Unwritable files cannot be selected. Permissions are checked again before writing; existing theme permissions are never changed automatically. Replacement files preserve the original mode. Fix ownership/permissions through your hosting tools or apply the reviewed differences in your code editor. MySQL / MariaDB require InnoDB for posts, postmeta and journal tables. SQLite requires the WordPress SQLite Database Integration drop-in 1.8.0 or later. **Recovery and data retention** Operations run in batches of up to 50 posts. Closing the tab stops subsequent requests; reopen the operation to resume. Completed requests remain recorded. Individual post changes and their journal updates use database transactions. On SQLite, each request also runs inside a write transaction. Before-mode rollback restores the native field name and unchanged values. After- mode rollback requires restoring the old name in the source definition first, keeping the same key, type and group. Rollback refuses later edits. Restore selected theme files separately. Resolve any reported difference before resuming, or recover from a full backup. The journal stores state and original metadata in `{prefix}fracf_jobs` and `{prefix} fracf_items`, and file copies in `{prefix}fracf_code`. Only administrators can use the tool. Metadata responses exclude raw field values; file previews show the relevant code lines to users allowed to edit themes. Journals are retained on deactivation and uninstall. Deleting a closed operation’s journal also removes its file backups and rollback ability. Keep database backups and journal access appropriately protected. This is an independent plugin by Esumo and is not affiliated with or endorsed by Advanced Custom Fields. ## Screenshots [⌊Choose a field and prepare a migration before or after renaming it.⌉⌊Choose a field and prepare a migration before or after renaming it.⌉[ Choose a field and prepare a migration before or after renaming it. [⌊Review recent operations and reopen their migration journals.⌉⌊Review recent operations and reopen their migration journals.⌉[ Review recent operations and reopen their migration journals. ## Installation 1. Install and activate Advanced Custom Fields (free or Pro) separately. Activation is blocked while the ACF API is unavailable. If ACF is later deactivated, an administrator notice explains the requirement; existing journals are retained. 2. Upload the plugin ZIP through Plugins > Add Plugin, then activate it. 3. Open Tools > Field Renamer. Only administrators can access the tool. ## FAQ ### Does this rename the field definition for me? Yes in Before renaming mode, for native database definitions. For PHP/JSON sources, rename the definition yourself and use After renaming. ### Does it update get_field() calls or templates? Optionally, after reviewing and checking the exact PHP file differences. Supported functions and limits are listed above. Other references require manual changes. ### What if two groups use the same field name? The tool checks the hidden ACF field-key reference. Records belonging to another field are skipped; missing, invalid or duplicate references block migration. ### Is the journal a full backup? No. It provides guarded rollback for unchanged migrated records. Keep a full database backup before using the tool. ### Can I rename a field using only different letter case? No. Case-only renames are refused because common WordPress database collations do not distinguish those names. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Esumo Field Renamer for ACF” is open source software. The following people have contributed to this plugin. Contributors * [ Esumo ](https://profiles.wordpress.org/jayfromesumo/) [Translate “Esumo Field Renamer for ACF” into your language.](https://translate.wordpress.org/projects/wp-plugins/esumo-field-renamer-for-acf) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/esumo-field-renamer-for-acf/), check out the [SVN repository](https://plugins.svn.wordpress.org/esumo-field-renamer-for-acf/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/esumo-field-renamer-for-acf/) by [RSS](https://plugins.trac.wordpress.org/log/esumo-field-renamer-for-acf/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0 * Initial free release: before/after modes, preview, conflict detection, batched migrations, reviewed theme-file changes, guarded rollback and history tab. ## Meta * Version **1.0** * Last updated **2 days ago** * Active installations **Fewer than 10** * WordPress version ** 6.2 or higher ** * Tested up to **7.1** * PHP version ** 7.4 or higher ** * Tags * [acf](https://wordpress.org/plugins/tags/acf/)[custom fields](https://wordpress.org/plugins/tags/custom-fields/) [developer-tools](https://wordpress.org/plugins/tags/developer-tools/)[migration](https://wordpress.org/plugins/tags/migration/) * [Advanced View](https://wordpress.org/plugins/esumo-field-renamer-for-acf/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/esumo-field-renamer-for-acf/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/esumo-field-renamer-for-acf/reviews/) ## Contributors * [ Esumo ](https://profiles.wordpress.org/jayfromesumo/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/esumo-field-renamer-for-acf/)