Title: ToolbarDropdownMenu
Published: May 6, 2021
Last modified: October 14, 2026

---

# ToolbarDropdownMenu

## In this article

 * [Usage](https://developer.wordpress.org/block-editor/reference-guides/components/toolbar-dropdown-menu/?output_format=md#usage)
    - [Inside BlockControls](https://developer.wordpress.org/block-editor/reference-guides/components/toolbar-dropdown-menu/?output_format=md#inside-blockcontrols)
 * [Props](https://developer.wordpress.org/block-editor/reference-guides/components/toolbar-dropdown-menu/?output_format=md#props)

ToolbarDropdownMenu can be used to add actions to a toolbar, usually inside a [Toolbar](https://developer.wordpress.org/block-editor/reference-guide/components/toolbar/)
or [ToolbarGroup](https://developer.wordpress.org/block-editor/reference-guide/components/toolbar-group/)
when used to create general interfaces. If you’re using it to add controls to your
custom block, you should consider using [BlockControls](https://developer.wordpress.org/block-editor/getting-started/fundamentals/block-in-the-editor/).

It has similar features to the [DropdownMenu](https://developer.wordpress.org/block-editor/reference-guide/components/dropdown-menu/)
component. Using `ToolbarDropdownMenu` will ensure that keyboard interactions in
a toolbar are consistent with the [WAI-ARIA toolbar pattern](https://www.w3.org/TR/wai-aria-practices/#toolbar).

## 󠀁[Usage](https://developer.wordpress.org/block-editor/reference-guides/components/toolbar-dropdown-menu/?output_format=md#usage)󠁿

To create general interfaces, you’ll want to render ToolbarButton in a [Toolbar](https://developer.wordpress.org/block-editor/reference-guide/components/toolbar/)
component.

    ```language-jsx
    import { Toolbar, ToolbarDropdownMenu } from '@wordpress/components';
    import {
        more,
        arrowLeft,
        arrowRight,
        arrowUp,
        arrowDown,
    } from '@wordpress/icons';

    function MyToolbar() {
        return (
            <Toolbar label="Options">
                <ToolbarDropdownMenu
                    icon={ more }
                    label="Select a direction"
                    controls={ [
                        {
                            title: 'Up',
                            icon: arrowUp,
                            onClick: () => console.log( 'up' ),
                        },
                        {
                            title: 'Right',
                            icon: arrowRight,
                            onClick: () => console.log( 'right' ),
                        },
                        {
                            title: 'Down',
                            icon: arrowDown,
                            onClick: () => console.log( 'down' ),
                        },
                        {
                            title: 'Left',
                            icon: arrowLeft,
                            onClick: () => console.log( 'left' ),
                        },
                    ] }
                />
            </Toolbar>
        );
    }
    ```

### 󠀁[Inside BlockControls](https://developer.wordpress.org/block-editor/reference-guides/components/toolbar-dropdown-menu/?output_format=md#inside-blockcontrols)󠁿

If you’re working on a custom block and you want to add controls to the block toolbar,
you should use [BlockControls](https://developer.wordpress.org/block-editor/getting-started/fundamentals/block-in-the-editor/)
instead.

    ```language-jsx
    import { BlockControls } from '@wordpress/block-editor';
    import { Toolbar, ToolbarDropdownMenu } from '@wordpress/components';
    import {
        more,
        arrowLeft,
        arrowRight,
        arrowUp,
        arrowDown,
    } from '@wordpress/icons';

    function Edit() {
        return (
            <BlockControls group="block">
                <ToolbarDropdownMenu
                    icon={ more }
                    label="Select a direction"
                    controls={ [
                        {
                            title: 'Up',
                            icon: arrowUp,
                            onClick: () => console.log( 'up' ),
                        },
                        {
                            title: 'Right',
                            icon: arrowRight,
                            onClick: () => console.log( 'right' ),
                        },
                        {
                            title: 'Down',
                            icon: arrowDown,
                            onClick: () => console.log( 'down' ),
                        },
                        {
                            title: 'Left',
                            icon: arrowLeft,
                            onClick: () => console.log( 'left' ),
                        },
                    ] }
                />
            </BlockControls>
        );
    }
    ```

## 󠀁[Props](https://developer.wordpress.org/block-editor/reference-guides/components/toolbar-dropdown-menu/?output_format=md#props)󠁿

This component accepts [the same API of the DropdownMenu](https://developer.wordpress.org/block-editor/reference-guide/components/dropdown-menu/#props)
component.

First published

May 6, 2021

Last updated

October 14, 2026

Edit article

[ Improve it on GitHub: ToolbarDropdownMenu ](https://github.com/WordPress/gutenberg/edit/trunk/packages/components/src/toolbar/toolbar-dropdown-menu/README.md)

[  Previous: ToolbarButton](https://developer.wordpress.org/block-editor/reference-guides/components/toolbar-button/)

[  Next: ToolbarGroup](https://developer.wordpress.org/block-editor/reference-guides/components/toolbar-group/)