ACF field renaming guides
Ten guides covering what ACF stores, why saved values disappear after a rename, and how to migrate top-level fields, nested subfields, Flexible Content layouts, and Local JSON definitions safely. No signup, no gate.
Start here
If you are about to rename a field, or something already went wrong.How to Rename an ACF Field Without Losing Data
The full safe sequence — what ACF actually stores, the queries that move it, and how to prove nothing was lost.
11 min readQuick answerACF Field Data Disappeared After Renaming — How to Get It Back
Your content is almost certainly still in the database. The fastest fix, and the two things not to do while it looks missing.
6 min readNested fields and layouts
Step-by-step answers for the exact nested target you need to rename.How to Rename an ACF Repeater Subfield Without Losing Data
Rename a populated Repeater subfield while preserving every row, field-key reference, and rollback path.
8 min readWalkthroughHow to Rename an ACF Group Subfield Without Losing Data
Rename a child inside an ACF Group without making its existing values disappear.
7 min readWalkthroughHow to Rename an ACF Flexible Content Subfield Safely
Rename a value-bearing subfield inside Flexible Content while preserving saved rows and layout order.
8 min readWalkthroughHow to Rename an ACF Flexible Content Layout Name
Change a Flexible Content layout name across saved posts without disturbing its subfield values or row order.
8 min readCompare approaches
Four ways to do it, and what each one costs you.Reference
How ACF storage works, including supported nested targets and blocked container renames.How ACF Stores Group, Repeater, and Flexible Content Fields
The metadata paths behind Group, Repeater, and Flexible Content fields, plus the boundary between safe subfield renames and container rewrites.
6 min readQuick answerACF Field Name vs Field Key: What Actually Stores Your Data
Two identifiers, two rows, one common misunderstanding — and why the difference is what makes a safe rename possible.
5 min readWalkthroughRenaming ACF Fields When You Use Local JSON
A rename becomes a code change and a data change. The order they must happen in, per environment.
9 min readOr skip the queries entirely.
Everything above is free and works. Field Renamer is for when the field is populated, the site belongs to a client, and you would rather see the affected record count than find out afterwards.