From 1472281cd5140a28e366cf436bdda1e2eff9c0ce Mon Sep 17 00:00:00 2001 From: David Woodhouse Date: Sat, 29 Nov 2025 08:47:34 +0000 Subject: [PATCH] Clarify percentage_command_topic and percentage_state_topic for MQTT fan (#157460) Co-authored-by: Jan Bouwhuis --- homeassistant/components/mqtt/strings.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/mqtt/strings.json b/homeassistant/components/mqtt/strings.json index 9bcb6d10a6a1..29a682f0763c 100644 --- a/homeassistant/components/mqtt/strings.json +++ b/homeassistant/components/mqtt/strings.json @@ -729,8 +729,8 @@ "data_description": { "payload_reset_percentage": "A special payload that resets the fan speed percentage state attribute to unknown when received at the percentage state topic.", "percentage_command_template": "A [template]({command_templating_url}) to compose the payload to be published at the percentage command topic.", - "percentage_command_topic": "The MQTT topic to publish commands to change the fan speed state based on a percentage. [Learn more.]({url}#percentage_command_topic)", - "percentage_state_topic": "The MQTT topic subscribed to receive fan speed based on percentage. [Learn more.]({url}#percentage_state_topic)", + "percentage_command_topic": "The MQTT topic to publish commands to change the fan speed state based on a percentage setting. The value shall be in the range from \"speed range min\" to \"speed range max\". [Learn more.]({url}#percentage_command_topic)", + "percentage_state_topic": "The MQTT topic subscribed to receive fan speed state. This is a value in the range from \"speed range min\" to \"speed range max\". [Learn more.]({url}#percentage_state_topic)", "percentage_value_template": "Defines a [template]({value_templating_url}) to extract the speed percentage value.", "speed_range_max": "The maximum of numeric output range (representing 100 %). The percentage step is 100 / number of speeds within the \"speed range\".", "speed_range_min": "The minimum of numeric output range (off not included, so speed_range_min - 1 represents 0 %). The percentage step is 100 / the number of speeds within the \"speed range\"."