Title: FieldPilot &#8211; AI &amp; JSON Copilot for ACF
Author: Harsh Prajapati
Published: <strong>September 29, 2026</strong>
Last modified: September 30, 2026

---

Search plugins

![](https://ps.w.org/fieldpilot-for-acf/assets/banner-772x250.png?rev=3718651)

![](https://ps.w.org/fieldpilot-for-acf/assets/icon-256x256.gif?rev=3720264)

# FieldPilot – AI & JSON Copilot for ACF

 By [Harsh Prajapati](https://profiles.wordpress.org/xaviermsd/)

[Download](https://downloads.wordpress.org/plugin/fieldpilot-for-acf.1.0.29.zip)

 * [Details](https://wordpress.org/plugins/fieldpilot-for-acf/#description)
 * [Reviews](https://wordpress.org/plugins/fieldpilot-for-acf/#reviews)
 *  [Installation](https://wordpress.org/plugins/fieldpilot-for-acf/#installation)
 * [Development](https://wordpress.org/plugins/fieldpilot-for-acf/#developers)

 [Support](https://wordpress.org/support/plugin/fieldpilot-for-acf/)

## Description

Advanced Custom Fields has not changed how you author fields in a decade: you click

through a UI, one field at a time. Meanwhile every developer has an AI that writes
JSON perfectly well. The missing piece was never generation – it was **safe application.

FieldPilot is an AI & JSON Copilot and configuration patch engine for ACF. Paste
JSON, see exactly
 what will change, apply only that, and roll back if you were 
wrong.

The rule the whole plugin is built around:

> **Nothing changes except what the JSON asked for.**

Set one field to required and that is the only byte that moves. Instructions,
 conditional
logic, wrapper classes, field keys and every other field in the group come out byte-
identical.

#### What it does

 * **Partial updates.** Change one setting on one field. ACF’s own importer can 
   only
    replace a whole field group; this changes precisely what you named.
 * **Diff preview.** Every change is shown before anything is written – added,
    
   removed, moved, and every setting that differs, old value to new.
 * **Target Isolation & Sibling Protection.** Target any node in a nested ACF tree
   (
   Repeater subfield, Flexible Content layout) with guarantees that sibling branches
   are untouched.
 * **Conflict detection.** Changing a field’s type, renaming a field that holds
   
   content, deleting something with data in it – each stops and asks, with the trade-
   offs spelled out. It never guesses.
 * **Snapshot and rollback.** Every batch is snapshotted with its complete field
   tree.
    One click restores the exact prior configuration. If a write fails verification,
   it rolls back automatically.
 * **Interactive Custom Field Builder (All 4 ACF Tabs).** Dynamic controls for General,
   
   Validation, Presentation, and Conditional Logic across all 36 ACF field types
   with responsive width, return formats, choices, sub-fields, layouts, and bulk
   appending.
 * **Deep 4-Tab Settings Mapping.** Full parameter mapping for General, Validation,
   
   Presentation, and Conditional Logic across all 36 ACF field types.
 * **Deep nesting.** Groups, Repeaters, Flexible Content layouts and Clone fields,
   
   at any depth, targeted by human path: `["Agent", "Contact", "Social"]`.
 * **Reads sloppy JSON.** AI output uses `group` for `field_group`, `description`
   for
    instructions, `true` where ACF wants `1`. All of it is normalised rather
   than rejected, so you paste instead of hand-fixing.
 * **Reads native ACF exports** too, in both directions.
 * **Visual 10-Step Guided Onboarding Tour.** An interactive walkthrough across 
   Dashboard, Import, and History with target spotlights, safety checklists, and
   replay controls.
 * **Target Field Group Gate & Inline Creation.** Select an existing group or click“
   + Add New Field Group” to generate one in ACF with instant AJAX selection and
   builder unlock.
 * **WordPress.org Compliant Uninstall Controls.** Configure data cleanup options
   in Settings to preserve or completely wipe snapshots, options, and logs on uninstall.
 * **REST API and WP-CLI** with full parity, so deployments can do everything the
   UI
    can.
 * **Knows what it cannot touch.** Field groups registered in PHP, or loaded from
   
   acf-json and not yet synced, are physically unpatchable. The plugin detects them
   up front and says so, instead of silently writing orphaned rows.

#### AI, without an AI dependency

The plugin never calls a language model. It publishes a schema and generates a
 
ready-to-paste prompt – including your field group’s current structure, so the model
stops inventing field names – and you use whatever AI you already pay for.

No API keys. No per-seat model cost. No site data leaving your server. No vendor
to
 be locked to. It works fully with zero configuration, and it keeps working when
a provider changes its pricing.

#### Requirements

WordPress 6.5+, PHP 8.1+, ACF 6.2+ (free or PRO). On ACF 6.8+ payloads are validated

against ACF’s own shipped field-type schemas, so validation tracks ACF automatically.
Repeater, Flexible Content, Clone and Gallery require ACF PRO; payloads using them
on a free install are refused with a clear message rather than a cryptic error.

## Screenshots

[⌊Inline ACF Field Group creator with instant AJAX auto-selection and safety gate⌉⌊
Inline ACF Field Group creator with instant AJAX auto-selection and safety gate⌉[

Inline ACF Field Group creator with instant AJAX auto-selection and safety gate

[⌊Interactive Custom Field Builder and AI prompt generator with 1-click model launchers⌉⌊
Interactive Custom Field Builder and AI prompt generator with 1-click model launchers⌉[

Interactive Custom Field Builder and AI prompt generator with 1-click model launchers

[⌊Side-by-side split review workbench showing diff preview and Target Isolated scope
badge⌉⌊Side-by-side split review workbench showing diff preview and Target Isolated
scope badge⌉[

Side-by-side split review workbench showing diff preview and Target Isolated scope
badge

[⌊Non-destructive conflict resolution with transparent trade-offs (keep, replace,
or duplicate)⌉⌊Non-destructive conflict resolution with transparent trade-offs (
keep, replace, or duplicate)⌉[

Non-destructive conflict resolution with transparent trade-offs (keep, replace, 
or duplicate)

[⌊History screen with snapshot audit logs and one-click rollback points⌉⌊History
screen with snapshot audit logs and one-click rollback points⌉[

History screen with snapshot audit logs and one-click rollback points

[⌊Dashboard showing field group health, editable database groups, and guided tour
launcher⌉⌊Dashboard showing field group health, editable database groups, and guided
tour launcher⌉[

Dashboard showing field group health, editable database groups, and guided tour 
launcher

## Installation

 1. Upload the plugin to `/wp-content/plugins/fieldpilot-for-acf/`, or install it through
    Plugins -> Add New.
 2. Activate it. ACF must already be active.
 3. Go to **FieldPilot** in the admin menu.

## FAQ

### Will this overwrite my existing fields?

No. An `update` changes only the settings your JSON names. Every other setting, 
and
 every other field, is preserved exactly. Field keys are never regenerated, 
so no existing content is ever orphaned by an update.

### What happens if something goes wrong?

Every batch is snapshotted before the first write, then verified afterwards by
 
re-reading what was saved. If the result does not match the plan, the snapshot is
restored automatically and you are told nothing was changed. You can also roll back
any past change manually from the History screen.

### How do I create a new field group if none exist yet?

Click “+ Add New Field Group” in the Target Field Group bar on the Import screen,

enter a title, and click “Create & Select”. FieldPilot creates the ACF group via
AJAX and instantly unlocks the custom field builder and prompt generator.

### What happens to my data when I delete the plugin?

By default, your settings and rollback history remain safely stored in the database

in case you reinstall. If you want a complete wipe, go to FieldPilot -> Settings
and enable “Wipe all FieldPilot data on uninstall”. When deleted through the WordPress
Plugins screen, all snapshots, options, and demo flags are cleanly purged.

### How do I replay or restart the guided onboarding tour?

You can restart the 10-step guided tour anytime by clicking the “Replay Guided Tour”

button at the top of the FieldPilot Dashboard or Settings screen.

### Can I delete fields?

Yes, but deliberately. The plugin scans for stored content first – including values

inside repeaters, which a name-based search would miss – and a delete that would
orphan content requires explicit confirmation.

### Why can’t it edit my field group?

If a group is registered in PHP with `acf_add_local_field_group()`, it does not 
live
 in the database, so nothing can be written to it. If it comes from an `acf-
json` file that has not been synced, the same applies. The Dashboard labels every
group so you know in advance; for JSON groups, sync them into the database first.

### Does it work with ACF free?

Yes, for every field type ACF free provides. Repeater, Flexible Content, Clone and

Gallery are ACF PRO features.

### Does it need an API key?

No. The plugin contains no AI integration at all – it generates prompts for whichever

AI you already use.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“FieldPilot – AI & JSON Copilot for ACF” is open source software. The following 
people have contributed to this plugin.

Contributors

 *   [ Harsh Prajapati ](https://profiles.wordpress.org/xaviermsd/)

[Translate “FieldPilot – AI & JSON Copilot for ACF” into your language.](https://translate.wordpress.org/projects/wp-plugins/fieldpilot-for-acf)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/fieldpilot-for-acf/),
check out the [SVN repository](https://plugins.svn.wordpress.org/fieldpilot-for-acf/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/fieldpilot-for-acf/)
by [RSS](https://plugins.trac.wordpress.org/log/fieldpilot-for-acf/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.29

 * Enhanced: Updated Guided Onboarding Tour Step 3 to highlight Target Field Group
   selection and inline creation gate.
 * Enhanced: Comprehensive documentation updates across README, FAQs, and developer
   screenshot guides.
 * Fixed: Resolved Plugin Check (PCP) NonceVerification warning on tour step parameter
   handling.

#### 1.0.28

 * Enhanced: Target Field Group creation UX with toggle button state switching between“
   + Add New Field Group” and “Close”.
 * Enhanced: Persistent creation form when no field groups exist, preventing dead-
   end UI states on fresh installations.
 * Enhanced: 100% WordPress.org guideline compliance for uninstall cleanup by configuring
   data purge exclusively via FieldPilot Settings.
 * Fixed: Form cancellation and focus state handling when closing field group creation
   box.

#### 1.0.27

 * Added: Uninstall data cleanup setting in FieldPilot Settings to wipe or preserve
   settings, history snapshots, and demo data when deleting the plugin.
 * Added: Safe, idempotent uninstall routine (uninstall.php) with prefix handling,
   demo marker checks, and scheduled cron cleanup.
 * Added: Direct “Add New Field Group” creation button with instant AJAX ACF group
   generation and auto-selection.
 * Added: Mandatory Step 1 gate requiring an active Target Field Group before unlocking
   the custom field builder or prompt generator.
 * Added: Soft red validation error borders and clear warning messages for required
   field labels, empty group titles, and validation range limits.
 * Fixed: Resolved JavaScript SyntaxError on variable declarations in custom field
   builder.
 * Fixed: Guided tour replay button icon and styling alignment in Settings and Dashboard
   screens.

#### 1.0.22

 * Fixed: Prevented premature sample diff cleanup and sidebar guide flash when transitioning
   from Step 8 to Step 9.
 * Fixed: Instantly hide previous overlay and spotlight before navigating across
   screens.

#### 1.0.21

 * Added: Non-revocable, disabled sample row in History table when empty to cleanly
   demonstrate rollback functionality.
 * Fixed: Ensured Step 8 targets conflict box directly instead of falling back to
   sidebar controls.
 * Fixed: Flawless step transitions between Import (Step 8) and History (Step 9).

#### 1.0.20

 * Fixed: Replaced collapsed empty notice in History screen with styled empty card
   to fix spotlight rendering.
 * Fixed: Ensured backward step navigation from History to Import page restores 
   editor tab and diff preview.
 * Enhanced: Robust retry and auto-recovery for tour spotlights across all screen
   transitions.

#### 1.0.19

 * Added: Visual 10-step guided onboarding tour with target spotlight overlay.
 * Added: Direct Settings and Schema & Operations Guide action links on Plugins 
   screen.
 * Added: Replay tour action on Dashboard and Settings screens.
 * Enhanced: Completely eliminated demo data from code, history screen, and UI.
 * Enhanced: Polished tour modal styling, close button, and diff review layout.

#### 1.0.18

 * Maintenance release.

#### 1.0.17

 * Maintenance release.

#### 1.0.15

 * Maintenance release.

#### 1.0.14

 * Hardened: Removed –file option and arbitrary file write from WP-CLI export command
   in favor of standard shell output redirection.

#### 1.0.13

 * Security: Converted Export admin screen to POST method with explicit nonce verification
   and permission checks.
 * Security: Sanitized and validated all components of uploaded JSON file structures
   before processing.
 * Security: Added explicit capability checks to all form and file submission handlers.

#### 1.0.12

 * Added: Side-by-side split review workbench in Tab 2 with live diff preview rendering
   directly alongside JSON editor.
 * Added: Target field group selector in JSON editor toolbar for dynamic template
   group assignment.
 * Added: Glowing pulse animation on Apply button once safety checklist checkboxes
   are confirmed.
 * Enhanced: Step 2 in AI tab split into clear sequential sub-steps (2A: Copy & 
   Open AI, 2B: Paste AI Output).
 * Fixed: Cleaned up append button labeling to avoid double plus signs.

#### 1.0.11

 * Added: Prominent bottom action bar (+ Append Field to Queue) directly below the
   4 ACF tabs in the Custom Field Builder.
 * Added: Instant Enter key triggers on all builder fields to append specifications
   immediately from any tab.
 * Added: Visual indicator badge confirming when fields are added to the queue.

#### 1.0.10

 * Added: Comprehensive in-app Schema & Operations Developer Guide in Tab 3 covering
   all 8 operations, target scope resolution, 4 ACF tabs parameter mapping, 36 field
   types reference matrix, and 1-click template loaders.
 * Fixed: Resolved DOM hierarchy and removed duplicate intent textarea in AI Prompt
   tab.
 * Fixed: Prevented WordPress admin footer (#wpfooter) from overlapping content.
 * Fixed: Standardized AI steps into full-width sequential workflow and aligned 
   editor action buttons.

#### 1.0.9

 * Added: Complete 36 ACF field type template patches in the JSON Editor template
   selector across 6 clean optgroups.
 * Enhanced: Reordered workflow tabs so Tab 1 is “1. Generate with AI” (default)
   and Tab 2 is “2. JSON Editor & Import”.
 * Enhanced: Interactive step guidance animations (pulsing ready states) when fields
   are queued to direct the user toward generating prompts and pasting responses.
 * Fixed: Standardized button alignments, heights (36px), and flex centering across
   all action bars.
 * Enhanced: AI prompt generator with compound multi-field examples and full 4-tab
   token parsing.

#### 1.0.8

 * Added: Full 4-tab interactive Custom Field Builder (General, Validation, Presentation,
   Conditional Logic) with dynamic type-adapting controls for return format, choices,
   sub-fields, layouts, post types, taxonomy, toolbar, button label, min/max/step,
   allowed MIME types, maxlength, placeholder, prepend, append, textarea rows, wrapper
   classes, and conditional logic.

#### 1.0.7

 * Added: Complete 4-tab parameter mapping (General, Validation, Presentation, Conditional
   Logic) and comprehensive specifications across all 36 ACF field types.
 * Added: Width and instructions controls in the Interactive Custom Field Builder
   with Enter key shortcuts.
 * Enhanced: Detailed user guide and complete JSON property mapping documentation
   in README.md and readme.txt.

#### 1.0.6

 * Added: Interactive Custom Field Builder in AI tab allowing developers to specify
   project-specific field names, choose from all 36 ACF types, toggle required flags,
   and append specs into prompt.
 * Enhanced: AI prompt generator with deep parameter rules, return formats, choice
   schemas, and bulk multi-field addition examples.

#### 1.0.5

 * Fixed: SchemaValidator now accepts 0/1 integer booleans alongside boolean true/
   false to prevent false warning notices with ACF internal storage format.

#### 1.0.4

 * Added: Multi-field bulk append without overwriting when clicking quick idea chips.
 * Added: Categorized quick dropdown covering all 36 ACF field types.
 * Added: Quick “Clear text” action in AI prompt tab.

#### 1.0.3

 * Fixed: TreeReader exportArray now populates complete field trees via acf_get_fields
   prior to export, guaranteeing byte-for-byte snapshot and rollback integrity.
 * Enhanced: Standardized button heights, flex vertical centering, Dashicons alignment,
   and AI launcher pills.

#### 1.0.2

 * Fixed: Diagnostics SelfTest export method to prevent TypeError on live ACF installs.
 * Added: Tab navigation URL hash synchronization (#editor, #ai, #guide).

#### 1.0.1

 * Fixed: adding a field produced a spurious warning about its key.
 * Import screen rewritten around numbered steps and tabs.
 * Added “Insert an example” template picker.
 * Added read-only mode and Diagnostics Self-Test runner.

#### 1.0.0

 * Initial release.

## Meta

 *  Version **1.0.29**
 *  Last updated **10 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 8.1 or higher **
 * Tags
 * [acf](https://wordpress.org/plugins/tags/acf/)[advanced custom fields](https://wordpress.org/plugins/tags/advanced-custom-fields/)
   [AI](https://wordpress.org/plugins/tags/ai/)[developer](https://wordpress.org/plugins/tags/developer/)
   [JSON](https://wordpress.org/plugins/tags/json/)
 *  [Advanced View](https://wordpress.org/plugins/fieldpilot-for-acf/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/fieldpilot-for-acf/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/fieldpilot-for-acf/reviews/)

## Contributors

 *   [ Harsh Prajapati ](https://profiles.wordpress.org/xaviermsd/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/fieldpilot-for-acf/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://profiles.wordpress.org/xaviermsd/)