From 0080b39d5e949645c53b68c356aa1edae9d045a7 Mon Sep 17 00:00:00 2001 From: Jay Patel Date: Thu, 23 Jul 2026 21:12:41 -0400 Subject: [PATCH 1/2] Revise useMica property options in themes.md Updated the 'useMica' property options and default value in the themes documentation. --- TerminalDocs/customize-settings/themes.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/TerminalDocs/customize-settings/themes.md b/TerminalDocs/customize-settings/themes.md index 363784d7..9d5e7d9c 100644 --- a/TerminalDocs/customize-settings/themes.md +++ b/TerminalDocs/customize-settings/themes.md @@ -96,20 +96,24 @@ This enables the Mica effect on this window, beneath all other UI layers. For Mi "window": { "applicationTheme": "system", - "useMica": true + "useMica": "mica" } }, ``` Note that when Mica is enabled for the window it is enabled under the entirety of the window, including as a backdrop for the Terminal panes in the window. This means that profiles which are using `opacity` without `useAcrylic` enabled will show through to the new Mica background. It is not currently possible to have an unblurred transparent background for the Terminal and a Mica background for the tabs / tab row simultaneously. +`"mica"` uses the standard Mica material. `"micaAlt"` uses the Mica Alt material, a variant of Mica with a stronger tint of the desktop wallpaper. `"none"` disables the backdrop. + +`true` and `false` are accepted as synonyms for `"mica"` and `"none"`, respectively. + **Property name:** `useMica` **Necessity:** Optional -**Accepts:** `true`, `false` +**Accepts:** `"none"`, `"mica"`, `"micaAlt"`, `true`, `false` -**Default value:** `false` +**Default value:** `"none"` > [!NOTE] > Mica is only available on Windows builds >= 22621. From 6e02f50976df793517642a22aa7a1892add69d84 Mon Sep 17 00:00:00 2001 From: Jay Patel Date: Thu, 23 Jul 2026 21:39:25 -0400 Subject: [PATCH 2/2] add availability note for micaAlt --- TerminalDocs/customize-settings/themes.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/TerminalDocs/customize-settings/themes.md b/TerminalDocs/customize-settings/themes.md index 9d5e7d9c..d9a63835 100644 --- a/TerminalDocs/customize-settings/themes.md +++ b/TerminalDocs/customize-settings/themes.md @@ -118,6 +118,9 @@ Note that when Mica is enabled for the window it is enabled under the entirety o > [!NOTE] > Mica is only available on Windows builds >= 22621. +> [!IMPORTANT] +> The `"micaAlt"` value is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview). + ### Window border This sets the color of the window border, when the window is active. When set to `null`, the border will use whatever the default color is for the OS theme.