Skip to content

Update useMica options for micaAlt and enum changes #969

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Jay Patel (JayPatel095) wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Update useMica options for micaAlt and enum changes #969

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0080b39
Revise useMica property options in themes.md
JayPatel095 Jul 24, 2026
6e02f50
add availability note for micaAlt
JayPatel095 Jul 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 10 additions & 3 deletions TerminalDocs/customize-settings/themes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,24 +96,31 @@ 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.

> [!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.
Expand Down