36. ACF Migration

Field Forge can import field groups and values from ACF Pro installations. The migration is safe and non-destructive.

Detection Sources

1. Database: acf-field-group and acf-field post types.
2. Local PHP: Groups registered via acf_add_local_field_group().
3. PostMeta: ACF reference keys in wp_postmeta.

$importer = FIELDFORGE_ACF_Import::instance();
$detection = $importer->detect();
// Returns: ['found' => true, 'groups' => 5, 'fields' => 47, 'posts_with_values' => 123, 'source' => 'database']

Group Import

$result = $importer->import_groups();
// Returns: ['migrated' => 5, 'errors' => 0, 'log' => [...]]

Before importing database-stored groups, Field Forge de-duplicates ACF group records by key/title and keeps the record with the most direct child acf-field posts. This protects migrations from old ACF databases where an empty duplicate group exists beside the populated group and would otherwise hide nested Repeater, Group, or Flexible Content children.

Value Migration (PRO)

Values are migrated in batches of 50 posts at a time.

$offset = 0;
do {
    $result = $importer->import_values_batch( $offset );
    $offset = $result['total_offset'];
} while ( ! $result['done'] );

echo 'Migration complete. ' . $result['migrated'] . ' values migrated.';

Field Type Mapping

—