diff --git a/COMPONENT_INDEX.md b/COMPONENT_INDEX.md
index c51c63d1..c9b306d2 100644
--- a/COMPONENT_INDEX.md
+++ b/COMPONENT_INDEX.md
@@ -1622,6 +1622,8 @@ None.
 | icon                       | No       | <code>let</code> | No       | <code>any</code>                                                  | <code>undefined</code>         | Specify the icon to render when the action panel is closed.<br />Defaults to `&lt;Switcher size={20} /&gt;`      |
 | closeIcon                  | No       | <code>let</code> | No       | <code>any</code>                                                  | <code>undefined</code>         | Specify the icon to render when the action panel is open.<br />Defaults to `&lt;Close size={20} /&gt;`           |
 | text                       | No       | <code>let</code> | No       | <code>string</code>                                               | <code>undefined</code>         | Specify the text.<br />Alternatively, use the named slot "text" (e.g., `&lt;div slot="text"&gt;...&lt;/div&gt;`) |
+| iconDescription            | No       | <code>let</code> | No       | <code>string</code>                                               | <code>undefined</code>         | Specify an icon tooltip.<br />This only works if `text` or a named slot "text" is not provided.                  |
+| tooltipAlignment           | No       | <code>let</code> | No       | <code>"start" &#124; "center" &#124; "end"</code>                 | <code>"center"</code>          | Set the alignment of the tooltip relative to the icon.<br />This only works if `iconDescription` is provided.    |
 | transition                 | No       | <code>let</code> | No       | <code>false &#124; import("svelte/transition").SlideParams</code> | <code>{ duration: 200 }</code> | Customize the panel transition (i.e., `transition:slide`).<br />Set to `false` to disable the transition         |
 | preventCloseOnClickOutside | No       | <code>let</code> | No       | <code>boolean</code>                                              | <code>false</code>             | Set to `true` to prevent the panel from closing when clicking outside                                            |
 
diff --git a/docs/src/COMPONENT_API.json b/docs/src/COMPONENT_API.json
index 92f9dedb..c43d1765 100644
--- a/docs/src/COMPONENT_API.json
+++ b/docs/src/COMPONENT_API.json
@@ -5878,6 +5878,29 @@
           "constant": false,
           "reactive": false
         },
+        {
+          "name": "iconDescription",
+          "kind": "let",
+          "description": "Specify an icon tooltip.\nThis only works if `text` or a named slot \"text\" is not provided.",
+          "type": "string",
+          "isFunction": false,
+          "isFunctionDeclaration": false,
+          "isRequired": false,
+          "constant": false,
+          "reactive": false
+        },
+        {
+          "name": "tooltipAlignment",
+          "kind": "let",
+          "description": "Set the alignment of the tooltip relative to the icon.\nThis only works if `iconDescription` is provided.",
+          "type": "\"start\" | \"center\" | \"end\"",
+          "value": "\"center\"",
+          "isFunction": false,
+          "isFunctionDeclaration": false,
+          "isRequired": false,
+          "constant": false,
+          "reactive": false
+        },
         {
           "name": "ref",
           "kind": "let",
diff --git a/types/UIShell/HeaderAction.svelte.d.ts b/types/UIShell/HeaderAction.svelte.d.ts
index 73ed2853..f41f40ce 100644
--- a/types/UIShell/HeaderAction.svelte.d.ts
+++ b/types/UIShell/HeaderAction.svelte.d.ts
@@ -31,6 +31,20 @@ type $Props = {
    */
   text?: string;
 
+  /**
+   * Specify an icon tooltip.
+   * This only works if `text` or a named slot "text" is not provided.
+   * @default undefined
+   */
+  iconDescription?: string;
+
+  /**
+   * Set the alignment of the tooltip relative to the icon.
+   * This only works if `iconDescription` is provided.
+   * @default "center"
+   */
+  tooltipAlignment?: "start" | "center" | "end";
+
   /**
    * Obtain a reference to the button HTML element
    * @default null