Skip to content
A composer install helper for Advanced Custom Fields PRO
Branch: master
Clone or download
randmanrjr and PhilippBaschke Updated with suggestion for alternate repository type (#16)
* Updated with suggestion for alternate repository type for those who don't want the plugin installed in ./wp-content/plugins/
Latest commit 772cec9 Jun 18, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/ACFProInstaller Allow 2 digits in the patch part of the version Jul 20, 2016
.gitignore Add support Apr 13, 2016
LICENSE Add MIT License Apr 13, 2016 Updated with suggestion for alternate repository type (#16) Jun 18, 2017
composer.json Improve composer.json Apr 15, 2016
phpunit.xml.dist Add support Apr 13, 2016

ACF PRO Installer

Packagist Packagist Travis Coveralls

A composer plugin that makes installing ACF PRO with composer easier.

It reads your 🔑 ACF PRO key from the environment or a .env file.


1. Add the package repository to the repositories field in composer.json (based on this gist):

  "type": "package",
  "package": {
    "name": "advanced-custom-fields/advanced-custom-fields-pro",
    "version": "*.*.*(.*)",
    "type": "wordpress-plugin",
    "dist": {
      "type": "zip",
      "url": ""
    "require": {
      "philippbaschke/acf-pro-installer": "^1.0",
      "composer/installers": "^1.0"

Replace "version": "*.*.*(.*)" with your desired version.

Replace "type": "wordpress-plugin" with "type": "library" if you would like to have ACF PRO installed in the ./vendor directory instead of ./wp-content/plugins. This may be desireable if for example, you are including ACF PRO in a WordPress theme.

2. Make your ACF PRO key available

Set the environment variable ACF_PRO_KEY to your ACF PRO key.

Alternatively you can add an entry to your .env file:

# .env (same directory as composer.json)

3. Require ACF PRO

composer require advanced-custom-fields/advanced-custom-fields-pro:*

You can specify an exact version (that matches your desired version).

If you use *, composer will install the version from the package repository (see 1). This has the benefit that you only need to change the version in the package repository when you want to update.

Be aware that composer update will only work if you change the version in the package repository. Decreasing the version only works if you require an exact version.

You can’t perform that action at this time.