home-assistant · frenck · Sep 3, 2025 · Jul 30, 2025 · Jul 31, 2025 · Aug 1, 2025
diff --git a/CODEOWNERS b/CODEOWNERS
@@ -70,7 +70,6 @@ source/_integrations/application_credentials.markdown @home-assistant/core
 source/_integrations/apprise.markdown @caronc
 source/_integrations/aprilaire.markdown @chamberlain2007
 source/_integrations/aprs.markdown @PhilRW
-source/_integrations/aps.markdown @tronikos
 source/_integrations/apsystems.markdown @mawoka-myblock @SonnenladenGmbH
 source/_integrations/aquacell.markdown @Jordi1990
 source/_integrations/aranet.markdown @aschmitz @thecode @anrijs
@@ -80,7 +79,7 @@ source/_integrations/arve.markdown @ikalnyi
 source/_integrations/aseko_pool_live.markdown @milanmeu
 source/_integrations/assist_pipeline.markdown @balloob @synesthesiam
 source/_integrations/assist_satellite.markdown @home-assistant/core @synesthesiam
-source/_integrations/asuswrt.markdown @kennedyshead @ollo69
+source/_integrations/asuswrt.markdown @kennedyshead @ollo69 @Vaskivskyi
 source/_integrations/atag.markdown @MatsNL
 source/_integrations/aten_pe.markdown @mtdcr
 source/_integrations/atlanticcityelectric.markdown @tronikos
@@ -247,6 +246,7 @@ source/_integrations/elv.markdown @majuss
 source/_integrations/elvia.markdown @ludeeus
 source/_integrations/emby.markdown @mezz64
 source/_integrations/emoncms.markdown @borpin @alexandrecuer
+source/_integrations/emoncms_history.markdown @alexandrecuer
 source/_integrations/emonitor.markdown @bdraco
 source/_integrations/emulated_hue.markdown @bdraco @Tho85
 source/_integrations/emulated_kasa.markdown @kbickar
@@ -257,7 +257,7 @@ source/_integrations/energyzero.markdown @klaasnicolaas
 source/_integrations/enigma2.markdown @autinerd
 source/_integrations/enmax.markdown @tronikos
 source/_integrations/enocean.markdown @bdurrer
-source/_integrations/enphase_envoy.markdown @bdraco @cgarwood @joostlek @catsmanac
+source/_integrations/enphase_envoy.markdown @bdraco @cgarwood @catsmanac
 source/_integrations/entur_public_transport.markdown @hfurubotten
 source/_integrations/environment_canada.markdown @gwww @michaeldavie
 source/_integrations/ephember.markdown @ttroy50 @roberty99
@@ -379,6 +379,7 @@ source/_integrations/home_connect.markdown @DavidMStraub @Diegorro98 @MartinHjel
 source/_integrations/home_plus_control.markdown @cgtobi
 source/_integrations/homeassistant.markdown @home-assistant/core
 source/_integrations/homeassistant_alerts.markdown @home-assistant/core
+source/_integrations/homeassistant_connect_zbt2.markdown @home-assistant/core
 source/_integrations/homeassistant_green.markdown @home-assistant/core
 source/_integrations/homeassistant_hardware.markdown @home-assistant/core
 source/_integrations/homeassistant_sky_connect.markdown @home-assistant/core
@@ -500,7 +501,6 @@ source/_integrations/lidarr.markdown @tkdrob
 source/_integrations/lifx.markdown @Djelibeybi
 source/_integrations/light.markdown @home-assistant/core
 source/_integrations/linak.markdown @abmantis
-source/_integrations/linear_garage_door.markdown @IceBotYT
 source/_integrations/linkedgo.markdown @balloob @bieniu @thecode @chemelli74 @bdraco
 source/_integrations/linkplay.markdown @Velleman
 source/_integrations/linux_battery.markdown @fabaff
@@ -544,7 +544,6 @@ source/_integrations/mediaroom.markdown @dgomes
 source/_integrations/melcloud.markdown @erwindouna
 source/_integrations/melissa.markdown @kennedyshead
 source/_integrations/melnor.markdown @vanstinator
-source/_integrations/mercury_nz.markdown @tronikos
 source/_integrations/met.markdown @danielhiversen
 source/_integrations/met_eireann.markdown @DylanGore
 source/_integrations/meteo_france.markdown @hacf-fr @oncleben31 @Quentame
@@ -828,6 +827,7 @@ source/_integrations/sisyphus.markdown @jkeljo
 source/_integrations/sky_remote.markdown @dunnmj @saty9
 source/_integrations/skybell.markdown @tkdrob
 source/_integrations/slack.markdown @tkdrob @fletcherau
+source/_integrations/sleep_as_android.markdown @tr4nt0r
 source/_integrations/sleepiq.markdown @mfugate1 @kbickar
 source/_integrations/slide.markdown @ualex73
 source/_integrations/slide_local.markdown @dontinelli
@@ -933,6 +933,7 @@ source/_integrations/time_date.markdown @fabaff
 source/_integrations/tmb.markdown @alemuro
 source/_integrations/todo.markdown @home-assistant/core
 source/_integrations/todoist.markdown @boralyl
+source/_integrations/togrill.markdown @elupus
 source/_integrations/tolo.markdown @MatthiasLohr
 source/_integrations/tomorrowio.markdown @raman325 @lymanepp
 source/_integrations/totalconnect.markdown @austinmroczek
@@ -941,7 +942,6 @@ source/_integrations/tplink.markdown @rytilahti @bdraco @sdb9696
 source/_integrations/tplink_omada.markdown @MarkGodwin
 source/_integrations/tplink_tapo.markdown @rytilahti @bdraco @sdb9696
 source/_integrations/traccar.markdown @ludeeus
-source/_integrations/traccar_server.markdown @ludeeus
 source/_integrations/tractive.markdown @Danielhiversen @zhulik @bieniu
 source/_integrations/trafikverket_camera.markdown @gjohansson-ST
 source/_integrations/trafikverket_ferry.markdown @gjohansson-ST
@@ -997,7 +997,6 @@ source/_integrations/voip.markdown @balloob @synesthesiam @jaminh
 source/_integrations/volumio.markdown @OnFreund
 source/_integrations/volvo.markdown @thomasddn
 source/_integrations/volvooncall.markdown @molobrakos
-source/_integrations/vulcan.markdown @Antoni-Czaplicki
 source/_integrations/wake_on_lan.markdown @ntilley905
 source/_integrations/wake_word.markdown @home-assistant/core @synesthesiam
 source/_integrations/wallbox.markdown @hesselonline

diff --git a/_config.yml b/_config.yml
@@ -107,9 +107,9 @@ social:
 
 # Home Assistant release details
 current_major_version: 2025
-current_minor_version: 8
-current_patch_version: 3
-date_released: 2025-08-21
+current_minor_version: 9
+current_patch_version: 0
+date_released: 2025-09-03
 
 # Either # or the anchor link to latest release notes in the blog post.
 # Must be prefixed with a # and have double quotes around it.

diff --git a/source/_dashboards/clock.markdown b/source/_dashboards/clock.markdown
@@ -19,21 +19,78 @@ Screenshot of the clock card
 
 All options for this card can be configured via the user interface.
 
-
 ## Card settings
 
-{% configuration_basic %}
-Title:
+{% configuration %}
+title:
   description: Adds a title to the top of the card
-Clock Size:
+  type: string
+  required: false
+clock_style:
+  description: Allows the clock to be displayed in a digital or analog style. Defaults to digital.
+  type: list
+  required: false
+  default: digital
+  keys:
+    digital:
+      description: Digital clock style.
+    analog:
+      description: Analog clock style.
+clock_size:
   description: Adjusts the size of the text allowing a wider range of use with different types of dashboards. Defaults to small.
-Display Seconds:
+  type: list
+  required: false
+  default: small
+  keys:
+    small:
+      description: Small clock size.
+    medium:
+      description: Medium clock size.
+    large:
+      description: Large clock size.
+show_seconds:
   description: Shows seconds alongside the clock, providing the time format is in a 12-hour format.
-Time Format:
+  type: boolean
+  required: false
+  default: false
+no_background:
+  description: Removes the background of the clock card.
+  type: boolean
+  required: false
+  default: false
+time_format:
   description: Allows the time format to be changed on a per-card level. Defaults to the user profile setting.
-Time Zone:
+  type: string
+  required: false
+time_zone:
   description: Change the timezone used for the time on a per-card level. Defaults to the user profile setting.
-{% endconfiguration_basic %}
+  type: string
+  required: false
+analog_options:
+  description: When using the analog clock style, this allows the user to configure the appearance of the clock.
+  type: map
+  required: false
+  keys:
+    border:
+      description: Shows a border around the clock face. Defaults to false.
+      type: boolean
+      required: false
+      default: false
+    ticks:
+      description: Shows ticks (indices) on the clock face. Defaults to hour.
+      type: list
+      required: false
+      default: hour
+      keys:
+        none:
+          description: No ticks are shown.
+        quarter:
+          description: Quarter hour ticks are shown.
+        hour:
+          description: Hour ticks are shown.
+        minute:
+          description: Minute ticks are shown.
+{% endconfiguration %}
 
 ### Examples
 
@@ -48,7 +105,6 @@ type: clock
 Screenshot of the basic clock card
 </p>
 
-
 Example of a larger clock card for tablet dashboards:
 
 ```yaml
@@ -107,3 +163,54 @@ title: New York 🦅
 <img src='/images/dashboards/clock_card_new_york.png' alt='Screenshot of a medium sized, 12 hour clock showing am/pm and seconds based in New York along with a title'>
 Screenshot of a medium sized, 12 hour clock showing am/pm and seconds based in New York along with a title
 </p>
+
+Analog clock with no border and hour ticks:
+
+```yaml
+type: clock
+clock_style: analog
+clock_size: medium
+analog_options:
+  border: false
+  ticks: hour
+```
+
+<p class='img'>
+<img src='/images/dashboards/clock_card_analog_hour_ticks.png' alt='Screenshot of a medium sized, analog clock and hour ticks'>
+Screenshot of a medium sized, analog clock and hour ticks
+</p>
+
+Analog clock with border and minute ticks showing seconds:
+
+```yaml
+type: clock
+clock_style: analog
+clock_size: medium
+show_seconds: true
+analog_options:
+  border: true
+  ticks: minute
+```
+
+<p class='img'>
+<img src='/images/dashboards/clock_card_analog_minute_ticks_border.png' alt='Screenshot of a medium sized, analog clock and minute ticks showing seconds'>
+Screenshot of a medium sized, analog clock and minute ticks showing seconds
+</p>
+
+Analog clock with a title, no ticks and border with seconds:
+
+```yaml
+type: clock
+clock_style: analog
+clock_size: medium
+show_seconds: true
+analog_options:
+  border: true
+  ticks: none
+title: Mountain Time
+```
+
+<p class='img'>
+<img src='/images/dashboards/clock_card_analog_no_ticks_border_title_mountain_time.png' alt='Screenshot of a medium sized, analog clock with a title, no ticks and border showing seconds'>
+Screenshot of a medium sized, analog clock with a title, no ticks and border showing seconds
+</p>
diff --git a/source/_dashboards/conditional.markdown b/source/_dashboards/conditional.markdown
@@ -198,9 +198,31 @@ users:
   type: list
 {% endconfiguration %}
 
+### Location
+
+Specify the visibility of the card based on the current user's current location. The location is based on the state of the `person` entity associated with the current user. If the current user does not have a `person` entity, this condition will always resolve to false.
+
+```yaml
+condition: location
+locations:
+  - home
+  - Home Neigborhood
+```
+
+{% configuration %}
+condition:
+  required: true
+  description: "`location`"
+  type: string
+locations:
+  required: true
+  description: A list of zones, which if any match the current state of the `person`, will cause this condition to be true. 
+  type: list
+{% endconfiguration %}
+
 ### And
 
-Specify that both conditions must be met.
+Specify that all conditions must be met.
 
 ```yaml
 condition: and
@@ -248,4 +270,27 @@ conditions:
   type: list
 {% endconfiguration %}
 
+### Not
+
+Specify that at least one of the conditions must not be met.
+
+```yaml
+condition: not
+conditions:
+  - condition: numeric_state
+    above: 0
+  - condition: user
+    users:
+      - 581fca7fdc014b8b894519cc531f9a04
+```
 
+{% configuration %}
+condition:
+  required: true
+  description: "`not`"
+  type: string
+conditions:
+  required: false
+  description: List of conditions to check. See [available conditions](#conditions-options).
+  type: list
+{% endconfiguration %}
diff --git a/source/_dashboards/energy.markdown b/source/_dashboards/energy.markdown
@@ -259,8 +259,9 @@ title:
   type: string
 layout:
   required: false
-  description: "`vertical` or `horizontal`. Determines the orientation (flow direction) of the card"
+  description: "`vertical`, `horizontal` or `auto`. Determines the orientation (flow direction) of the card. `auto` changes it based on the screen size."
   type: string
+  default: auto
 group_by_area:
   required: false
   description: Whether to group the devices by area

diff --git a/source/_dashboards/todo-list.markdown b/source/_dashboards/todo-list.markdown
@@ -76,6 +76,11 @@ display_order:
   description: "Optionally sorts the items in the to-do list for display. Options are: `none`: Show the list in its original order. `alpha_asc`: Sort the list in alphabetical order. `alpha_desc`: Sort the list in reverse alphabetical order. `duedate_asc`: Sort the list by due date (soonest first). `duedate_desc`: Sort the list by reverse due date (soonest last)."
   type: string
   default: "none"
+item_tap_action:
+  required: false
+  description: "Defines the behavior when an item's body is clicked. Options are: `edit` (opens the edit dialog), `toggle` (marks or unmarks the item as completed, hiding the edit dialog)."
+  type: string
+  default: "edit"  
 {% endconfiguration %}
 
 ### Examples

diff --git a/source/_docs/blueprint/selectors.markdown b/source/_docs/blueprint/selectors.markdown
@@ -1414,7 +1414,7 @@ would return ["Green"] and in the last example it returns ["g"].
 ## State selector
 
 The state selector shows a list of states for a provided entity of which
-one can be selected.
+one or more can be selected.
 
 ![Screenshot of an state selector](/images/blueprints/selector-state.png)
 
@@ -1427,10 +1427,16 @@ hide_states:
   description: The states to exclude from the list of options
   type: list
   required: false
+multiple:
+  description: >
+    Allows selecting multiple states. If set to `true`, the resulting value of
+    this selector will be a list instead of a single string value.
+  type: boolean
+  default: false  
 {% endconfiguration %}
 
 The output of this selector is the select state (not the translated or
-prettified name shown in the frontend).
+prettified name shown in the frontend), or a list of states if `multiple` is true.
 
 For example: `heat_cool`.
 

@@ -8,7 +8,7 @@ ha_quality_scale: internal
 ha_domain: ai_task
 ha_codeowners:
   - '@home-assistant/core'
-ha_integration_type: system
+ha_integration_type: entity
 ---
 
 The **AI Task** {% term integration %} allows you to use AI to help you configure Home Assistant.