WordPress Developer Resources

register_nav_menu( string $location, string $description )

Registers a navigation menu location for a theme.

Parameters

$locationstringrequired: Menu location identifier, like a slug.
$descriptionstringrequired: Menu location descriptive text.

More Information

See register_nav_menus() for creating multiple menus at once.
This function automatically registers custom menu support for the theme therefore you do not need to call add_theme_support( 'menus' );
This function actually works by simply calling register_nav_menus() in the following way:

register_nav_menus( array( $location => $description ) );

You may use wp_nav_menu() to display your custom menu.

Source

function register_nav_menu( $location, $description ) {
	register_nav_menus( array( $location => $description ) );
}

View all references View on Trac View on GitHub

Changelog

Version	Description
3.0.0	Introduced.

User Contributed Notes

Skip to note 3 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note
Register a “primary” nav menu” example
```
<?php
add_action( 'after_setup_theme', 'register_my_menu' );
function register_my_menu() {
  register_nav_menu( 'primary', __( 'Primary Menu', 'theme-slug' ) );
}
?>
```
Log in to add feedback
Skip to note 4 content

Chris Everson 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
Register a navigation menu, extended example:
```
add_action( 'after_setup_theme', 'register_primary_menu' );

function register_primary_menu() {
	register_nav_menu( 'primary', __( 'Primary Menu', 'theme-text-domain' ) );
}
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.