This function will add a new options sub page to the wp-admin sidebar.

All data saved on an options page is global. This means it is not attached to any particular post or page, but is saved in the wp_options table.


This function requires at least ACF PRO version 5.0.0. or the Options Page Add-on

This function must be used before the action admin_menu (priority 99) as this is when the options pages are added to WordPress.


<?php acf_add_options_sub_page($page); ?>
  • $page (mixed) A string for the page title, or an array of settings. If left blank, default settings will be used.

The parameters of acf_add_options_sub_page() are similar to those of acf_add_options_page() but with 1 difference; The ‘parent_slug’ setting cannot be blank.

By default, the ‘parent_slug’ setting is set to ‘acf-options’ (the default options page), however, this can be changed to any other admin page.

See list of available parameters


Default options sub page

This example shows how to create an options sub page called ‘Social’. The following code is placed in the functions.php file. By calling this function without a custom ‘parent_slug’, the default will be used. Furthermore, if the default options page does not yet exist, it will be added.


if( function_exists('acf_add_options_sub_page') ) {


Custom options sub page

This example shows how to create a customized options page and store the data in a variable for later use.


if( function_exists('acf_add_options_page') ) {
 	// add parent
	$parent = acf_add_options_page(array(
		'page_title' 	=> 'Theme General Settings',
		'menu_title' 	=> 'Theme Settings',
		'redirect' 		=> false
	// add sub page
		'page_title' 	=> 'Social Settings',
		'menu_title' 	=> 'Social',
		'parent_slug' 	=> $parent['menu_slug'],


We use cookies to offer you a better browsing experience, analyze site traffic and personalize content. Read about how we use cookies and how you can control them in our Cookie Policy. If you continue to use this site, you consent to our use of cookies.