From 69c8e602e31fad99a0775e37f36754fd5bd0ed9b Mon Sep 17 00:00:00 2001 From: Laufmaschine <215712047+Laufmaschine@users.noreply.github.com> Date: Wed, 29 Apr 2026 14:49:13 +0000 Subject: [PATCH 1/2] Update name of actions --- source/_actions/light.toggle.markdown | 22 +++++++++++----------- source/_actions/light.turn_off.markdown | 16 ++++++++-------- source/_actions/light.turn_on.markdown | 18 +++++++++--------- 3 files changed, 28 insertions(+), 28 deletions(-) diff --git a/source/_actions/light.toggle.markdown b/source/_actions/light.toggle.markdown index 2ec94131335a..9cfc7ee90275 100644 --- a/source/_actions/light.toggle.markdown +++ b/source/_actions/light.toggle.markdown @@ -9,9 +9,9 @@ related_actions: - light.turn_off --- -The **Toggle** action flips a light to the opposite state. If the light is off, it turns on. If it's on, it turns off. This is handy for a single button or a motion sensor that should cycle a light without you having to know what state it's in. +The **Toggle light** action flips a light to the opposite state. If the light is off, it turns on. If it's on, it turns off. This is handy for a single button or a motion sensor that should cycle a light without you having to know what state it's in. -When **Toggle** turns a light on, you can also set the brightness, color, color temperature, or a transition at the same time, just like you would with **Turn on**. Those options are ignored when **Toggle** turns the light off. +When **Toggle light** turns a light on, you can also set the brightness, color, color temperature, or a transition at the same time, just like you would with **Turn on light**. Those options are ignored when **Toggle light** turns the light off. {% include actions/ui_header.md %} @@ -21,7 +21,7 @@ To toggle a light from an automation or a script: 2. Open an existing automation or script, or select **Create** to start a new one. 3. If you're setting up a new automation, add a trigger in the **When** section. Scripts don't need a trigger. They run when something else calls them. 4. In the **Then do** section, select **Add action**. -5. From the search box, search for and select **Light: Toggle**. +5. From the search box, search for and select **Light: Toggle light**. 6. Under **Targets**, choose what you want to toggle: - To toggle a specific light, select the entity. - To toggle every light in a room, select an area. @@ -138,9 +138,9 @@ profile: ## Good to know -- The **Toggle** action works on any light {% term entity %}, such as bulbs, groups, fixtures, or strips. -- When **Toggle** turns a light on, any brightness, color, or transition options you set are applied. When it turns a light off, those options are ignored. -- If you use **Toggle** on a group of lights, each light in the group flips its own state. Some lights may turn on while others turn off. To treat a group as one unit, create a dedicated [light group](/integrations/group/) first. +- The **Toggle light** action works on any light {% term entity %}, such as bulbs, groups, fixtures, or strips. +- When **Toggle light** turns a light on, any brightness, color, or transition options you set are applied. When it turns a light off, those options are ignored. +- If you use **Toggle light** on a group of lights, each light in the group flips its own state. Some lights may turn on while others turn off. To treat a group as one unit, create a dedicated [light group](/integrations/group/) first. - If you already know the state you want, use [Turn on a light](/actions/light.turn_on/) or [Turn off a light](/actions/light.turn_off/) instead. They make the intent clearer in the automation's name. {% include actions/try_it.md %} @@ -151,7 +151,7 @@ profile: Wire a physical button or a dashboard tile to a single toggle action so it acts like a light switch. -- **Action**: Light: Toggle +- **Action**: Light: Toggle light - **Target**: Hallway light {% details "YAML example for a one-button hallway toggle" %} @@ -169,7 +169,7 @@ action: | When the toggle turns the kitchen light on, have it come up dim and warm instead of at full blast. -- **Action**: Light: Toggle +- **Action**: Light: Toggle light - **Target**: Kitchen light - **Brightness percentage**: 40 - **Color**: warm_white @@ -193,7 +193,7 @@ action: | Keep a smart button on the wall and flip the hallway light whenever you press it. A great way to add a light switch where there isn't one. - **Trigger**: Device: Button pressed -- **Action**: Light: Toggle +- **Action**: Light: Toggle light - **Target**: Hallway light {% details "YAML example for a button-driven hallway toggle" %} @@ -222,7 +222,7 @@ automation: | When the bathroom motion sensor fires, flip the light. The next motion event flips it back, so you can also use the same automation to cut the light when you leave. - **Trigger**: Motion sensor detects motion -- **Action**: Light: Toggle +- **Action**: Light: Toggle light - **Target**: Bathroom light {% details "YAML example for toggling the bathroom light on motion" %} @@ -247,7 +247,7 @@ automation: | When the pantry door opens, flip the light. Close the door and the same trigger flips it back off the next time around. - **Trigger**: Door sensor opens -- **Action**: Light: Toggle +- **Action**: Light: Toggle light - **Target**: Pantry light {% details "YAML example for a pantry door toggle" %} diff --git a/source/_actions/light.turn_off.markdown b/source/_actions/light.turn_off.markdown index edf5a642d879..8f53c24ed7f8 100644 --- a/source/_actions/light.turn_off.markdown +++ b/source/_actions/light.turn_off.markdown @@ -8,7 +8,7 @@ related_actions: - light.toggle --- -The **Turn off** action turns a light off. You can switch it off instantly, add a transition so it fades out smoothly, or ask it to flash briefly before going dark. +The **Turn off light** action turns a light off. You can switch it off instantly, add a transition so it fades out smoothly, or ask it to flash briefly before going dark. This action works with any light {% term entity %} in Home Assistant, whether it's a single bulb, a group of lights, or a smart fixture. If the light is already off, calling the action does nothing. @@ -20,7 +20,7 @@ To turn a light off from an automation or a script: 2. Open an existing automation or script, or select **Create** to start a new one. 3. If you're setting up a new automation, add a trigger in the **When** section. Scripts don't need a trigger. They run when something else calls them. 4. In the **Then do** section, select **Add action**. -5. From the search box, search for and select **Light: Turn off**. +5. From the search box, search for and select **Light: Turn off light**. 6. Under **Targets**, choose what you want to turn off: - To turn off a specific light, select the entity. - To turn off every light in a room, select an area. @@ -72,7 +72,7 @@ flash: ## Good to know -- The **Turn off** action works on any light {% term entity %}, such as bulbs, groups, fixtures, or strips. +- The **Turn off light** action works on any light {% term entity %}, such as bulbs, groups, fixtures, or strips. - If the light is already off, calling this action does nothing. - Not every light supports a transition or a flash. Home Assistant quietly skips options the device can't handle. - To reverse this action, use [Turn on a light](/actions/light.turn_on/). To flip a light between on and off with a single call, use [Toggle a light](/actions/light.toggle/). @@ -85,7 +85,7 @@ flash: Fade the bedroom light out over five seconds, which is a much nicer way to end a movie than an instant off. -- **Action**: Light: Turn off +- **Action**: Light: Turn off light - **Target**: Bedroom light - **Transition**: 5 seconds @@ -106,7 +106,7 @@ action: | Target a floor instead of a specific entity and Home Assistant resolves it to every light on that floor. -- **Action**: Light: Turn off +- **Action**: Light: Turn off light - **Target**: Ground floor {% details "YAML example for turning off every light on a floor" %} @@ -125,7 +125,7 @@ action: | Turn the porch light off automatically as the sun comes up. No more wasted electricity after you've already gone to bed or left for work. - **Trigger**: Sun: Above horizon -- **Action**: Light: Turn off +- **Action**: Light: Turn off light - **Target**: Porch light {% details "YAML example for a sunrise porch light off" %} @@ -149,7 +149,7 @@ automation: | When the last person leaves home, turn off every light in the house. A simple way to save energy without having to think about it. - **Trigger**: Zone: Everyone leaves home -- **Action**: Light: Turn off +- **Action**: Light: Turn off light - **Target**: All lights (by label) {% details "YAML example for turning off all lights when nobody is home" %} @@ -179,7 +179,7 @@ automation: | At 11 in the evening, fade every light in the living room out over ten seconds. A calmer way to end the day than flipping a switch. - **Trigger**: Time: 23:00 -- **Action**: Light: Turn off +- **Action**: Light: Turn off light - **Target**: Living room - **Transition**: 10 seconds diff --git a/source/_actions/light.turn_on.markdown b/source/_actions/light.turn_on.markdown index d4ee55f5ff06..f55cec73fe51 100644 --- a/source/_actions/light.turn_on.markdown +++ b/source/_actions/light.turn_on.markdown @@ -9,7 +9,7 @@ related_actions: - light.toggle --- -The **Turn on** action turns a light on. You can simply switch it on, or go further and set the brightness, color, color temperature, or an effect at the same time. +The **Turn on light** action turns a light on. You can simply switch it on, or go further and set the brightness, color, color temperature, or an effect at the same time. This action works with any light {% term entity %} in Home Assistant, whether it's a single bulb, a group of lights, or a smart fixture. If the light is already on, calling the action updates its attributes (such as brightness or color) without flashing off first. @@ -21,7 +21,7 @@ To turn a light on from an automation or a script: 2. Open an existing automation or script, or select **Create** to start a new one. 3. If you're setting up a new automation, add a trigger in the **When** section. Scripts don't need a trigger. They run when something else calls them. 4. In the **Then do** section, select **Add action**. -5. From the search box, search for and select **Light: Turn on**. +5. From the search box, search for and select **Light: Turn on light**. 6. Under **Targets**, choose what you want to turn on: - To turn on a specific light, select the entity. - To turn on every light in a room, select an area. @@ -138,7 +138,7 @@ profile: ## Good to know -- The **Turn on** action works on any light {% term entity %}, such as bulbs, groups, fixtures, or strips. +- The **Turn on light** action works on any light {% term entity %}, such as bulbs, groups, fixtures, or strips. - If the light is already on, the call updates its attributes (brightness, color) without flashing off first. - Not every light supports every field. A bulb that only dims ignores color fields, and a color-only light ignores color temperature. Home Assistant quietly skips fields the device can't handle. - To reverse this action, use [Turn off a light](/actions/light.turn_off/). To flip a light between on and off with a single call, use [Toggle a light](/actions/light.toggle/). @@ -151,7 +151,7 @@ profile: When you start winding down in the evening, dim the kitchen light to a warm white tone. -- **Action**: Light: Turn on +- **Action**: Light: Turn on light - **Target**: Kitchen light - **Brightness percentage**: 80 - **Color**: warm_white @@ -174,7 +174,7 @@ action: | A long transition is a gentle way to wake up. Instead of snapping the light on, fade it up slowly. -- **Action**: Light: Turn on +- **Action**: Light: Turn on light - **Target**: Bedroom light - **Brightness percentage**: 100 - **Transition**: 10 seconds @@ -197,7 +197,7 @@ action: | Target an area instead of a specific entity and Home Assistant resolves it to every light inside the room. -- **Action**: Light: Turn on +- **Action**: Light: Turn on light - **Target**: Living room - **Brightness percentage**: 60 @@ -219,7 +219,7 @@ action: | Greet the evening by turning the porch light on at a warm white tone as the sun drops below the horizon. Nice and welcoming without running the light at full power. - **Trigger**: Sun: Below horizon -- **Action**: Light: Turn on +- **Action**: Light: Turn on light - **Target**: Porch light - **Brightness percentage**: 60 - **Color**: warm_white @@ -249,7 +249,7 @@ Fade the bedroom light up over ten seconds at 7 in the morning on weekdays. A ki - **Trigger**: Time: 07:00 - **Condition**: Day of the week is Monday to Friday -- **Action**: Light: Turn on +- **Action**: Light: Turn on light - **Target**: Bedroom light - **Brightness percentage**: 100 - **Transition**: 10 seconds @@ -287,7 +287,7 @@ When you arrive home after dark, turn on every light in the living room at a com - **Trigger**: Person: Paulus changes to home - **Condition**: Sun is below horizon -- **Action**: Light: Turn on +- **Action**: Light: Turn on light - **Target**: Living room - **Brightness percentage**: 60 From 64e151f2c9e5ca555a76a6d6a37c9c42f0f59e22 Mon Sep 17 00:00:00 2001 From: Laufmaschine <215712047+Laufmaschine@users.noreply.github.com> Date: Wed, 29 Apr 2026 15:18:17 +0000 Subject: [PATCH 2/2] Update name of light action --- source/_triggers/air_quality.smoke_detected.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_triggers/air_quality.smoke_detected.markdown b/source/_triggers/air_quality.smoke_detected.markdown index 17741bb2ec9e..9fe2bfe819c1 100644 --- a/source/_triggers/air_quality.smoke_detected.markdown +++ b/source/_triggers/air_quality.smoke_detected.markdown @@ -89,7 +89,7 @@ Picture this: it is the middle of the night and a smoke sensor activates in the - **Target**: All smoke sensors (by label) - **Trigger when**: Any - **For at least**: 00:00:00 -- **Action**: Light: Turn on (flash) +- **Action**: Light: Turn on light (flash) - **Action**: Send a mobile notification {% details "YAML example for a smoke detection alert" %}