Register a callback on WordPress’s admin_bar_menu hook, then add a node to the supplied WP_Admin_Bar object. Give the node an explicit, unique id, a visible title, and an href generated for the destination. Leave out parent for a top-level shortcut, or set it to an existing node ID for a submenu item.
What you are changing
The WordPress Toolbar—often called the admin bar—is the horizontal toolbar shown to logged-in users on the front end and in the dashboard. This API is separate from the dashboard’s main administrative navigation menu. You can add links with WordPress’s built-in WP_Admin_Bar class; a third-party plugin is not required for a basic shortcut.
Add a top-level shortcut
Place this code in a small site-specific plugin or, when appropriate for your setup, a child theme’s functions.php:
<?php
add_action( 'admin_bar_menu', 'my_custom_toolbar_link', 100 );
function my_custom_toolbar_link( $wp_admin_bar ) {
$wp_admin_bar->add_node( array(
'id' => 'my-custom-shortcut',
'title' => 'My Shortcut',
'href' => admin_url( 'edit.php' ),
) );
}After the code runs, “My Shortcut” appears as a top-level Toolbar link and points to the post-list screen generated by admin_url( 'edit.php' ). Replace the label and URL helper with the destination your site needs.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minutePC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11#1 Best Overall
Why each argument matters
id: The node’s identifier. Make it stable and unique; an empty ID is invalid.title: The text displayed in the Toolbar.href: The destination URL. Without it, the node is text rather than a clickable link.parent: An optional parent-node ID. Omit it for a top-level item.meta: Optional attributes and metadata, such as a CSS class,rel,target, or tooltiptitle.group: An optional flag for a grouping node. The group itself is not visible; its child nodes are.
Put the shortcut inside an existing Toolbar menu
Set parent to the ID of a node that exists in the rendered Toolbar. For example, this places the link under the standard site-name menu when that node is present:
add_action( 'admin_bar_menu', 'my_toolbar_child_link', 100 );
function my_toolbar_child_link( $wp_admin_bar ) {
$wp_admin_bar->add_node( array(
'id' => 'my-toolbar-child',
'parent' => 'site-name',
'title' => 'Edit Posts',
'href' => admin_url( 'edit.php' ),
) );
}The parent ID must actually be available in the context where the callback runs. A missing or unavailable parent will not produce the intended nesting.
Create your own parent menu
Add the parent first, then add children whose parent value matches that parent’s ID:
add_action( 'admin_bar_menu', 'my_toolbar_menu', 100 );
function my_toolbar_menu( $wp_admin_bar ) {
$wp_admin_bar->add_node( array(
'id' => 'my-tools-menu',
'title' => 'My Tools',
'group' => true,
) );
$wp_admin_bar->add_node( array(
'id' => 'my-tools-settings',
'parent' => 'my-tools-menu',
'title' => 'Settings',
'href' => admin_url( 'options-general.php' ),
) );
}A group node is useful when several related shortcuts should share one menu. Give every node its own explicit ID.
Choosing the hook and method
admin_bar_menu is the normal hook for modifying the Toolbar. WordPress passes your callback the WP_Admin_Bar instance, on which you call add_node(). The object is not generally available outside Toolbar-building contexts. WordPress also provides wp_before_admin_bar_render, a pre-render hook, but use admin_bar_menu for ordinary node registration.
add_menu() is an alias of add_node(). Either works; using add_node() consistently makes the examples and intent clearer. The method was introduced in WordPress 3.1.0. Its API history lists lang and dir metadata from 4.5.0 and menu_title from 6.5.0; availability can still depend on the WordPress version running your site.
Rank #4
Make the destination safe and appropriate
An href only creates a Toolbar link. It does not grant permission to the destination. If a page is restricted, check the relevant capability before adding the node, and protect the destination itself with its own authorization checks. Hiding a link is not a security control.
Use WordPress URL helpers such as admin_url() instead of hard-coding a domain, so the link follows the site’s configured address. If you use a custom front-end route, generate that URL with the appropriate WordPress function for that route.
Do these 3 things before closing this tab:
1Repair Windows errors before they cause bigger problems2Fix the driver behind crashes, sound loss and screen glitches3Clear out junk files and repair common Windows errorsQuick Recap
Best Value
Troubleshoot a missing or misplaced shortcut
- No item appears: Confirm the callback is loaded, the hook name is exactly
admin_bar_menu, and the current user can see the Toolbar. - The item is text, not a link: Add a valid
href. - The item is not nested: Check that
parentexactly matches an existing node ID in this Toolbar context. - Another item changes or disappears: Replace duplicate IDs with unique, stable IDs.
- The link opens but access is denied: Review the destination’s capability and authorization rules; the Toolbar registration did not provide access.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
