From 205877eb2a9ebcc464c08634fed6ce9a32f07a75 Mon Sep 17 00:00:00 2001
From: j4n-e4t <130256240+j4n-e4t@users.noreply.github.com>
Date: Mon, 7 Aug 2023 19:05:45 +0200
Subject: [PATCH] Clarify docs for unifi network sensors (#28476)

* Add more clarification to the unifi sensor configuration
Fixes #28463

* Add info that unifi doesn't support global rx/tx sensors
Fixes #28463

* fixed typo

* changed style of warning message

* changed the wording of the explaination

* Apply suggestions from code review

* Apply suggestions from code review

* Fix typo in UniFi

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/unifi.markdown | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/source/_integrations/unifi.markdown b/source/_integrations/unifi.markdown
index d27816c34e7..70dfb562247 100644
--- a/source/_integrations/unifi.markdown
+++ b/source/_integrations/unifi.markdown
@@ -112,6 +112,14 @@ Entities appear for each WLAN. Changing the state of WLAN will trigger a reconfi
 
 ## Sensor
 
+These sensors are disabled by default. Enabling a sensor adds a new device to Home Assistant for every connected client in your network. This can add complexity to large networks.
+
+1. To enable the sensors, on the UniFi integration page, select **Configure**. 
+2. Go to page 3/3 and enable the sensors.
+
+Currently, it is not possible to get a global bandwidth sensor for a UDM router. The integration only supports per-device sensors.
+
+
 ### Bandwidth sensor
 
 Get entities reporting receiving and transmitting bandwidth per network client.