Refine theme settings for light and dark modes

karwosts · web-flow · commit 03ea5318a020 · 2025-12-17T06:53:32.000-08:00
Updated theme settings for light and dark modes with clearer descriptions and added behavior for dark mode overrides.
diff --git a/source/_integrations/frontend.markdown b/source/_integrations/frontend.markdown
@@ -165,11 +165,12 @@ There are two themes-related actions:
 
 | Data attribute | Description                                                                                         |
 | -------------- | --------------------------------------------------------------------------------------------------- |
-| `name`         | Name of the theme to set, `default` for the default theme or `none` to restore to the default.      |
-| `mode`         | If the theme should be applied in light or dark mode `light` or `dark` (Optional, default `light`). |
+| `name`         | Name of the theme to be used by default. Set `default` to use the default _Home Assistant_ theme. If omitted, the previous setting will be retained. |
+| `name_dark`    | Name of the theme to be used by default for dark mode. Set `default` to use the default _Home Assistant_ theme, or `none` to delete the dark mode override. If omitted, the previous setting will be retained. |
 
-If no dark mode backend theme is set, the light mode theme will also be used in dark mode.
-The backend theme settings will be saved and restored on a restart of Home Assistant.
+If the dark mode has never been set, or has been erased by setting `name_dark` to `none`, the light mode theme will also be used in dark mode.
+
+The theme settings will be saved and restored on a restart of Home Assistant.
 
 ### Manual theme selection
 
