get_nav_menu_locations()

Retrieves all registered navigation menu locations and the menus assigned to them.

Return

(int[]) Associative array of registered navigation menu IDs keyed by their location name. If none are registered, an empty array.

function get_nav_menu_locations() {
	$locations = get_theme_mod( 'nav_menu_locations' );
	return ( is_array( $locations ) ) ? $locations : array();
}

Uses
Uses	Description
wp-includes/theme.php: get_theme_mod()	Retrieves theme modification value for the active theme.

Used By
Used By	Description
wp-includes/rest-api/endpoints/class-wp-rest-menu-locations-controller.php: WP_REST_Menu_Locations_Controller::prepare_item_for_response()	Prepares a menu location object for serialization.
wp-includes/rest-api/endpoints/class-wp-rest-menu-locations-controller.php: WP_REST_Menu_Locations_Controller::prepare_links()	Prepares links for the request.
wp-includes/rest-api/endpoints/class-wp-rest-menus-controller.php: WP_REST_Menus_Controller::get_menu_locations()	Returns the names of the locations assigned to the menu.
wp-includes/rest-api/endpoints/class-wp-rest-menus-controller.php: WP_REST_Menus_Controller::handle_locations()	Updates the menu’s locations from a REST request.
wp-includes/nav-menu.php: _wp_menus_changed()	Handles menu config after theme change.
wp-includes/nav-menu.php: wp_delete_nav_menu()	Deletes a navigation menu.
wp-includes/nav-menu.php: has_nav_menu()	Determines whether a registered nav menu location has a menu assigned to it.
wp-includes/nav-menu.php: wp_get_nav_menu_name()	Returns the name of a navigation menu.
wp-includes/nav-menu-template.php: wp_nav_menu()	Displays a navigation menu.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::__construct()	Constructor.

Changelog
Version	Description
3.0.0	Introduced.