apply_filters( 'nav_menu_link_attributes', array $atts, WP_Post $item, stdClass $args, int $depth )

Filters the HTML attributes applied to a menu item’s anchor element.



(array) The HTML attributes applied to the menu item's <a> element, empty strings are ignored.

  • 'title'
    (string) Title attribute.
  • 'target'
    (string) Target attribute.
  • 'rel'
    (string) The rel attribute.
  • 'href'
    (string) The href attribute.
  • 'aria_current'
    (string) The aria-current attribute.


(WP_Post) The current menu item.


(stdClass) An object of wp_nav_menu() arguments.


(int) Depth of menu item. Used for padding.

More Information

  • The filter permits full control over what HTML attributes are added to menus generated with the WP Menu API.
  • This filter runs per nav item, vs providing a list of all nav elements at once.
  • Note that the callback function must return a value after it is finished processing or the result will be empty.


File: wp-includes/class-walker-nav-menu.php

View on Trac


Version Description
4.1.0 The $depth parameter was added.
3.6.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.