Search Over 30,000 FREE Plugins from the Official WordPress Plugin Directory Repository

ACF Options Page Admin

Allows easy creation of options pages using Advanced Custom Fields Pro without needing to do any PHP coding. Requires that ACF5 Pro is installed (or A

This is an add on plugin for Advanced Custom Fields (ACF) 5 + the Options Page Add On (or ACF Pro). This plugin will not provide any functionality unless ACF 5 and the Options Page Add On (or ACF5 Pro) is installed

This plugin provides an admin interface for adding options pages in ACF including all options for ACF options pages. Most options are selectable, for example the menu location, capability and where to save field values to.

For more information see Other Notes and Screenshots

Author John A. Huebner II
Contributors Hube2
Tags acf, options-page
  1. options-page-admin-for-acf screenshot 1

    Options Page Admin List

  2. options-page-admin-for-acf screenshot 2

    Add Top Level Options Page

  3. options-page-admin-for-acf screenshot 3

    Add Child Options Page

  1. Extract files to folder named acf-options-page-adder in your plugin folder (usually /wp-content/plugins/options-page-admin-for-acf/)
  2. Upload files
  3. Activate it from the Plugins Page


  • added more missing text domains
  • completed adding Portuguese (pt_PT) translation
  • converted True/False radio fields to ACF true/false UI fields
  • added Russian (ru_RU) translations - thanks @antonvyukov


  • Added missing text domain
  • Typos corrected
  • Add Portuguese (pt_PT) translation - thanks @pedro-mendonca


  • removed github updater support



  • First release to


  • Added filter to use page tiles instead of menu title for location setting when editing ACF field group
  • Corrected some bugs
  • Removed fieldset duplicator


  • correction to when filter is added to prevent multiple additions of filter


  • ?


  • fixed bug, titles being removed from all other post types


  • Changed default redirect value to false
  • Added admin column for "Save To"
  • Added function get_option_page_id() and get_options_page_id()


  • removed post title
  • added required title field
  • slug field now required
  • added validation to slug field
  • removed no longer needed message field about post title
  • updated instructions and messages for several fields


  • changed capability to "manage_options"
  • added filter to allow changing of capability


  • corrected conditional logic on slug field


  • added remove nag filter


  • corrected white-space error


  • added donation box


  • added support for github updater


= * Removed comment from field group duplicator


  • Corrects Issue #17


  • Added checks to ensure that ACF5 Pro is installed and active


  • Corrected bug, duplicated field groups not showing on options pages
  • Added support for save/loading to/from post objects added in ACF v5.2.7


  • Added support for autoload option added in ACF v5.2.8


  • Added field group duplicator


  • Added support for redirect
  • Added support for menu position
  • Added support for icon (dashicons)
  • Added sorting of sub options pages


  • Corrected bug in adding top level option page
  • Corrected bug in display of location
  • Corrected bug in options page slugs not being saved correctly
  • Removed support for ACF4
  • Changed default value of location to "None"


  • Removed $post global in function admin_columns_content(), not needed, post_id is passed by hook.
  • Added code to prevent plugin from running if not included by WP.
  • Reworked function acf_add_options_sub_page() to not use have_posts() function so it's less likely to interfere with other queries.
  • Other minor code changes that don't effect operation


  • Updated to be compatable with ACF-Pro (continues to work on ACF4)


  • Initial Stable Version


  • initial release

None Yet

Other Notes

Github Repository

This plugin is also on GitHub

Change Capability

The capability required to add/edit options page settings is "manage_options". This capability can be changed by adding a filter.

add_filter('acf-options-page-adder/capability', 'my_acf_options_page_adder_cap');
function my_acf_options_page_adder_cap($cap) {
  $cap = 'edit_published_posts';
  return $cap;

Saving Values to the Options Page Post

ACF v5.2.7 added the ability to save options page fields to a post ID. This plugin will let you save the options to the same post ID of the post created when adding an options page using this plugin. You can even use get_fields($options_page_id) without needing to worry about getting the fields for the options page itself. Why? because all the fields used for creating the options page start with an underscore _ and will not be returned by get_fields(). The only thing you need to be careful of is not using any of the field names used by this plugin, which should be extremely easy since they all start with acfop.

Get Post ID for Options Page

A function and a filter are available for getting the correct ACF $post_id value to use for getting values from the options page. This function/filter will return 'options' for options pages stored in options or will return the correct post ID if options are saved to a post. The correct ID is returned based on the "menu_slug" value of the options page.

/ example 1: function get_options_page_id()

// get the post_id of an options page
$post_id = get_options_page_id('my_options_page_slug');
// get a value using $post_id
$value = get_field('my_option_field', $post_id);

// or it can be combined like this
$value = get_field('my_option_field', get_options_page_id('my_options_page_slug'));
// example 2: by filter
$default = 'option',
$slug = 'my_options_page_slug';
$post_id = apply_filters('get_option_page_id_filter', $default, $slug);
$value = get_field('my_option_field', $post_id);

// or it can be combined like this
$value = get_field('my_option_field', apply_filters('get_option_page_id_filter', $default, $slug));

There is a condition where you will get the incorrect post id. This condition is created by having a top level redirect page that is set to redirect to the first sub options page. If there is no sub options page that exists then it will return the value for the top level options page. If you later create a sub options page it will return the new value from the sub options page. This is why I have see the default value of redirect to false. If you want the top level page to redirect the you need to be aware that it can cause you issues later down the road if you haven't created a sub option page. You should also specifically set the order of sub options pages so that these do not change at some point in the future because adding a new options page with the same order as the existing top level page will alter the save and get location to the new options page. There's noting I can do about this, it the way it works. When setting up ACF options pages to save to a post instead of options you must be more precise in with the options page arguments.

Font Awesome Support

Please note that this plugin does not enqueue or include Font Awswsome in the admin of your site. If you include Font Awsome in your admin then you can use Font Awesome Icons for the icons of top level options page. For example if you wanted to use Address Book Icon then all you need to do is add fa fa-address-book into the Icon field when adding or editing the options page.

Remove Nag

If you would like to remove my little nag that appears on some admin pages add the following to your functions.php file

add_filter('remove_hube2_nag', '__return_true');
Version 3.7.3

Requires WordPress version: 3.5 or higher

Compatible up to: 4.7.2

Last Updated 11 Feb 2017

Date Added: 04 Jan 2017

Plugin Homepage


0 stars
0 ratings


Not Enough Data

Works: 0
Broken: 0