unregister_nav_menu

The timeline below displays how wordpress function unregister_nav_menu has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.5

/**
 * Unregisters a navigation menu location for a theme.
 *
 * @since 3.1.0
 *
 * @global array $_wp_registered_nav_menus
 *
 * @param string $location The menu location identifier.
 * @return bool True on success, false on failure.
 */
function unregister_nav_menu($location)
{
    global $_wp_registered_nav_menus;
    if (is_array($_wp_registered_nav_menus) && isset($_wp_registered_nav_menus[$location])) {
        unset($_wp_registered_nav_menus[$location]);
        if (empty($_wp_registered_nav_menus)) {
            _remove_theme_support('menus');
        }
        return true;
    }
    return false;
}

WordPress Version: 4.8

/**
 * Unregisters a navigation menu location for a theme.
 *
 * @since 3.1.0
 * @global array $_wp_registered_nav_menus
 *
 * @param string $location The menu location identifier.
 * @return bool True on success, false on failure.
 */
function unregister_nav_menu($location)
{
    global $_wp_registered_nav_menus;
    if (is_array($_wp_registered_nav_menus) && isset($_wp_registered_nav_menus[$location])) {
        unset($_wp_registered_nav_menus[$location]);
        if (empty($_wp_registered_nav_menus)) {
            _remove_theme_support('menus');
        }
        return true;
    }
    return false;
}

WordPress Version: 4.5

/**
 * Unregisters a navigation menu location for a theme.
 *
 * @global array $_wp_registered_nav_menus
 *
 * @param string $location The menu location identifier.
 * @return bool True on success, false on failure.
 */
function unregister_nav_menu($location)
{
    global $_wp_registered_nav_menus;
    if (is_array($_wp_registered_nav_menus) && isset($_wp_registered_nav_menus[$location])) {
        unset($_wp_registered_nav_menus[$location]);
        if (empty($_wp_registered_nav_menus)) {
            _remove_theme_support('menus');
        }
        return true;
    }
    return false;
}

WordPress Version: 4.3

/**
 * Unregisters a navigation menu for a theme.
 *
 * @global array $_wp_registered_nav_menus
 *
 * @param string $location The menu location identifier.
 * @return bool True on success, false on failure.
 */
function unregister_nav_menu($location)
{
    global $_wp_registered_nav_menus;
    if (is_array($_wp_registered_nav_menus) && isset($_wp_registered_nav_menus[$location])) {
        unset($_wp_registered_nav_menus[$location]);
        if (empty($_wp_registered_nav_menus)) {
            _remove_theme_support('menus');
        }
        return true;
    }
    return false;
}

WordPress Version: 4.1

/**
 * Unregisters a navigation menu for a theme.
 *
 * @param string $location The menu location identifier.
 * @return bool True on success, false on failure.
 */
function unregister_nav_menu($location)
{
    global $_wp_registered_nav_menus;
    if (is_array($_wp_registered_nav_menus) && isset($_wp_registered_nav_menus[$location])) {
        unset($_wp_registered_nav_menus[$location]);
        if (empty($_wp_registered_nav_menus)) {
            _remove_theme_support('menus');
        }
        return true;
    }
    return false;
}

WordPress Version: 3.9

/**
 * Unregisters a navigation menu for a theme.
 *
 * @param array $location the menu location identifier
 *
 * @return bool True on success, false on failure.
 */
function unregister_nav_menu($location)
{
    global $_wp_registered_nav_menus;
    if (is_array($_wp_registered_nav_menus) && isset($_wp_registered_nav_menus[$location])) {
        unset($_wp_registered_nav_menus[$location]);
        if (empty($_wp_registered_nav_menus)) {
            _remove_theme_support('menus');
        }
        return true;
    }
    return false;
}

WordPress Version: 3.7

/**
 * Unregisters a navigation menu for a theme.
 *
 * @param array $location the menu location identifier
 *
 * @return bool True on success, false on failure.
 */
function unregister_nav_menu($location)
{
    global $_wp_registered_nav_menus;
    if (is_array($_wp_registered_nav_menus) && isset($_wp_registered_nav_menus[$location])) {
        unset($_wp_registered_nav_menus[$location]);
        return true;
    }
    return false;
}