diff --git a/source/_integrations/shelly.markdown b/source/_integrations/shelly.markdown
index 75076820b6d..5dcb16ae7b2 100644
--- a/source/_integrations/shelly.markdown
+++ b/source/_integrations/shelly.markdown
@@ -253,16 +253,16 @@ The firmware limits the transition time to 5 seconds.
 
 The integration offers device services which can be triggered by a configuration button.
 
-### OTA update
+### OTA firmware update
 
 Trigger device OTA firmware update.
 
-#### Buttons
+#### Update entities
 
-- OTA Update
-  - triggers the OTA update process for latest stable version
-- OTA Update Beta (_disabled by default_)
-  - triggers the OTA update process for latest beta version
+- Firmware update
+  - triggers the OTA firmware update process to the latest stable version
+- Beta firmware update (_disabled by default_)
+  - triggers the OTA firmware update process to the latest beta version
 
 ### Reboot
 
@@ -315,5 +315,5 @@ Please check from the device Web UI that the configured server is reachable.
 - Only supports firmware 0.8 and later for generation 2 devices
 - Generation 1 "Shelly 4Pro" and "Shelly Sense" are not supported (devices based on old CoAP v1 protocol)
 - Before set up, battery-powered devices must be woken up by pressing the button on the device.
-- OTA update service does not support battery-powered devices
+- For battery-powered devices, the `update` platform entities only inform about the availability of firmware updates but are not able to trigger the update process.
 - Frequency sensors for generation 2 energy monitoring devices are supported by firmware 1.0.0 beta 6 or later.