WordPress action hook · part of WordPress core

wp_add_nav_menu_item

A WordPress core action that 2 plugins also fire themselves, running on 400+ sites between them.

“Fires immediately after a new navigation menu item has been added.”

How to use wp_add_nav_menu_item

It's an action: your callback runs at that point and receives 3 arguments. Nothing needs to be returned. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_action( 'wp_add_nav_menu_item', function( $menu_id, $menu_item_db_id, $args ) {
	// Your code runs here.
}, 10, 3 );

Argument names come from WP Weixin's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

This hook is fired by WordPress core too. Official reference on developer.wordpress.org →

2 plugins that fire wp_add_nav_menu_item

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. WP Weixin icon WP Weixin300+ installs do_action( 'wp_add_nav_menu_item', $menu_id, $menu_item_db_id, $args ) inc/class-wp-weixin-menu.php:521
  2. BZOTech Theme Core icon BZOTech Theme Core100+ installs do_action( 'wp_add_nav_menu_item', $menu_id, $menu_item_db_id, $args ) libs/importer/wordpress-importer.php:1415

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.