node package manager



Exports AdvancedCustomFields to PHP. Grunt acts like a headless browser to fetch the export code and puts it into your destination file. Now also supports ACF 5.0 and higher.

Getting Started

This plugin requires Grunt ~0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-acf --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


acf task

Run this task with the grunt acf command.

Task targets, files and options may be specified according to the grunt Configuring tasks guide. ### Options


Type: String default: undefined

This is your projects local URL. We need this to login.


Type: String default undefined

This is your wordpress user. It should have access to the ACF-Admin panel.


Type: String default undefined

This is the password for you wordpress user.


Type: Object default false

Whether we'd like to enable loading the plugins automatically.


Type: String default none

The Path to your export file


Type: String default none

You can add extra-loading logic to your Export file. It has to be valid PHP and it will be rendered inside the if brackets like so: if( <condition>){ [..ACF Fields..] }

options: {
    baseUrl: '',
    user: 'wpAdminUser',
    password: 'wpAdminPW123!!11',
    condition: "defined('APPLICATION_MODE') && APPLICATION_MODE === 'live'",
    addons: {
        repeater: true,
        gallery: true,
        flexible: true,
        options: true,
dest: 'path/to/my/acf-export.php'