How to Import Images in ACF Gallery

CSV Importer Plus Pro imports gallery iamges into posts, pages, and custom post types. You can import as many images as you like. This feature is available in pro version. To import images using the CSV Importer Plus for ACF plugin, you must either:

  1. Upload the images to the WordPress media library beforehand, e.g.,
    http://beni.test:8080/wp-content/uploads/2024/09/image1.jpg
  2. Ensure the images are hosted within your domain. The plugin will then automatically upload or register the images in the WordPress media library.
    Examples:
    • http://beni.test:8080/photo/image300.jpg
    • http://beni.test:8080/photo/pexels-pixabay-247759.jpg

Note: External images are not supported, and the plugin will not register or upload them to the WordPress media library.
Example of an unsupported external image:
https://cdn.pixabay.com/photo/2025/01/26/20/33/robin-9361610_1280.jpg

Key Mapping Format

For a simple gallery field, use acf_gallery_field_name.

In a repeater, use repeater_acf_gallery_field_name_0r, where:

  • repeater is the keyword,
  • acf_gallery_field_name is the name of the ACF gallery field,
  • 0r represents the row index.

In flexible content, use flexible_content_gallery_field_name_0r, where:

  • flexible_content is the keyword,
  • acf_gallery_field_name is the name of the ACF gallery field,
  • 0r represents the layout index.

In a flexible content repeater, use flexible_content_gallery_field_name_0r_0r, where:

  • flexible_content is the keyword,
  • acf_gallery_field_name is the name of the ACF gallery field,
  • The first 0r represents the repeater row index,
  • The second 0r represents the layout index.

After providing the correct column names in the CSV using the specified format, the plugin will automatically map them.