register_nav_menu( string $location, string $description )

Registers a navigation menu location for a theme.

Contents

Parameters
More Information
Source
Related
- Uses
Changelog
User Contributed Notes

Parameters

$location string Required: Menu location identifier, like a slug.
$description string Required: 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

File: wp-includes/nav-menu.php. View all references

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

View on Trac View on GitHub

Uses

Uses
Uses	Description
register_nav_menus() wp-includes/nav-menu.php	Registers navigation menu locations for a theme.

Changelog

Changelog
Version	Description
3.0.0	Introduced.

User Contributed Notes

Skip to note 1 content

You must log in to vote on the helpfulness of this noteVote results for this note: 6You must log in to vote on the helpfulness of this note

Contributed by Codex — 8 years ago
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 2 content

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

Contributed by Chris Everson — 7 years ago
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.