diff --git a/source/_integrations/shelly.markdown b/source/_integrations/shelly.markdown
index 473de62c9a7..fece0e1d7e8 100644
--- a/source/_integrations/shelly.markdown
+++ b/source/_integrations/shelly.markdown
@@ -16,11 +16,14 @@ Integrate [Shelly devices](https://shelly.cloud) into Home Assistant.
 
 ## Configuration
 
-To add a Shelly device to your installation, go to **Configuration** >> **Integrations** in the UI, click the + to add a new integration and search for Shelly. Devices will be automatically discovered when on the same network and listed on the integrations page. Click on "Configure" of the discovered device to add it to Home Assistant.
+To add a Shelly device to your installation, make sure they are connected to your Wi-Fi network first. Next, go to **Configuration** >> **Integrations** in the UI. If the new device is on the same network as Home Assistant, it is discovered automatically. Clicking "Configure" on the discovered device, adds it to Home Assistant. If your device isn't discovered automatically, click the button with `+` sign on the integrations page and from the list of integrations, select **Shelly** and follow the instructions shown.
 
-A device can also be added manually, click the button with `+` sign on the integrations page and from the list of integrations, select **Shelly** and follow the instructions shown.
+<div class="note">
+Integration is communicating directly with the device; cloud connection is not needed.
+</div>
 
 ## Known issues and limitations
 
 - Only supports firmware 1.8 and later
 - Support relays, lights (with brightness), sensors and rollers
+- Support for battery powered devices is currently very limited