diff --git a/commands-yml/commands/device/network/toggle-wifi.yml b/commands-yml/commands/device/network/toggle-wifi.yml
index ed8e0b8fb..bf57a1e86 100644
--- a/commands-yml/commands/device/network/toggle-wifi.yml
+++ b/commands-yml/commands/device/network/toggle-wifi.yml
@@ -1,6 +1,14 @@
 ---
 name: Toggle WiFi
-short_description: Switch the state of the wifi service
+short_description: Switch the state of the WiFi service
+
+description:
+  >
+    Switch the state of the WiFi service.
+
+    Since Android Q, a method to change the WiFi service state has been restricted. [#12327](https://github.com/appium/appium/issues/12327)
+    Please toggle the state via UI instead of this method.
+    The UI flow depends on devices. Please make sure to encode the correct UI flow on your target device under test.
 
 example_usage:
   java: