ACF Driver

The ACF driver allows importing data directly into Advanced Custom Fields, supporting all field types including repeaters, groups, and flexible content.

Supported Field Types

Field Type	Support	Notes
Text, Textarea	Full	Direct mapping
Number, Range	Full	Automatic type conversion
Email, URL	Full	With validation
Select, Checkbox, Radio	Full	Match by value or label
True/False	Full	Accepts boolean or 1/0
Image, File	Full	URL sideloading
Gallery	Full	Multiple URLs
Repeater	Full	Nested mapping
Group	Full	Nested mapping
Flexible Content	Full	With layout discriminator
Relationship, Post Object	Full	By ID or slug
Taxonomy	Full	By ID, slug, or name
User	Full	By ID, email, or login
Date, DateTime, Time	Full	Multiple format support
Google Map	Full	Lat/lng object

Basic Usage

1. Select ACF as your target driver
2. Choose the post type with ACF fields
3. UMIE will display all available ACF field groups

Repeater Fields

For repeater imports, your source data should be structured as arrays:

{
  "team_members": [
    { "name": "John", "role": "Developer" },
    { "name": "Jane", "role": "Designer" }
  ]
}

Map the parent repeater, then expand to map child fields.

Flexible Content

Include the acf_fc_layout key to specify which layout to use:

{
  "content_blocks": [
    { "acf_fc_layout": "text_block", "content": "Hello world" },
    { "acf_fc_layout": "image_block", "image": "https://..." }
  ]
}

Media Fields

Image and file fields accept URLs. UMIE will:

1. Check if media already exists (by URL hash)
2. Download and sideload if new
3. Attach to the post
4. Update the field with attachment ID