{"id":136876,"date":"2021-08-10T23:54:48","date_gmt":"2021-08-10T23:54:48","guid":{"rendered":"https:\/\/developer.wordpress.org\/block-editor\/reference-guides\/components\/tools-panel-header\/"},"modified":"2026-09-04T14:34:11","modified_gmt":"2026-09-04T14:34:11","slug":"tools-panel-header","status":"publish","type":"blocks-handbook","link":"https:\/\/developer.wordpress.org\/block-editor\/reference-guides\/components\/tools-panel-header\/","title":{"rendered":"ToolsPanelHeader"},"content":{"rendered":"

This feature is still experimental. \u201cExperimental\u201d means this is an early implementation subject to drastic and breaking changes.<\/p>\n

<\/p>\n

This component renders a tools panel’s header including a menu.<\/p>\n

Usage<\/h2>\n

This component is generated automatically by its parent
\nToolsPanel<\/code>.<\/p>\n

In general, this should not be used directly.<\/strong><\/p>\n

Props<\/h2>\n

dropdownMenuProps<\/code>: {}<\/code><\/h3>\n

The dropdown menu props to configure the panel’s DropdownMenu<\/code>.<\/p>\n

    \n
  • Type: DropdownMenuProps<\/code><\/li>\n
  • Required: No<\/li>\n<\/ul>\n

    headingLevel<\/code>: 1 | 2 | 3 | 4 | 5 | 6 | '1' | '2' | '3' | '4' | '5' | '6'<\/code><\/h3>\n

    The heading level of the panel’s header.<\/p>\n

      \n
    • Required: No<\/li>\n
    • Default: 2<\/code><\/li>\n<\/ul>\n

      label<\/code>: string<\/code><\/h3>\n

      Text to be displayed within the panel header. It is also passed along as the
      \nlabel<\/code> for the panel header’s DropdownMenu<\/code>.<\/p>\n

        \n
      • Required: Yes<\/li>\n<\/ul>\n

        resetAll<\/code>: () => void<\/code><\/h3>\n

        The resetAll<\/code> prop provides the callback to execute when the “Reset all” menu
        \nitem is selected. Its purpose is to facilitate resetting any control values
        \nfor items contained within this header’s panel.<\/p>\n

          \n
        • Required: Yes<\/li>\n<\/ul>\n

          toggleItem<\/code>: ( label: string ) => void<\/code><\/h3>\n

          This is executed when an individual control’s menu item is toggled. It
          \nwill update the panel’s menu item state and call the panel item’s onSelect<\/code> or
          \nonDeselect<\/code> callbacks as appropriate.<\/p>\n

            \n
          • Required: Yes<\/li>\n<\/ul>\n","protected":false},"author":0,"featured_media":0,"parent":134435,"menu_order":352,"template":"","meta":{"footnotes":""},"class_list":["post-136876","blocks-handbook","type-blocks-handbook","status-publish","hentry","type-handbook"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/blocks-handbook\/136876","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/blocks-handbook"}],"about":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/types\/blocks-handbook"}],"version-history":[{"count":9,"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/blocks-handbook\/136876\/revisions"}],"predecessor-version":[{"id":182966,"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/blocks-handbook\/136876\/revisions\/182966"}],"up":[{"embeddable":true,"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/blocks-handbook\/134435"}],"wp:attachment":[{"href":"https:\/\/developer.wordpress.org\/wp-json\/wp\/v2\/media?parent=136876"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}