diff --git a/docs/guide/voice-assistant.md b/docs/guide/voice-assistant.md
index 586ae9f2..bea5595a 100644
--- a/docs/guide/voice-assistant.md
+++ b/docs/guide/voice-assistant.md
@@ -109,6 +109,10 @@ Set `ELEVENLABS_API_KEY` in your environment and restart the hub.
 - Ensure no other app is using the microphone
 - Try refreshing the page
 
+### Microphone permission fails on Xiaomi/MIUI devices
+
+If voice cannot start on a Xiaomi/MIUI device, or the browser cannot request microphone permission, check the "Display over other apps" permission for Xiaomi Wallet and similar apps. Floating windows, payment or wallet overlays, chat bubbles, screen recorders, translation tools, eye-comfort tools, and game assistants may interfere with the browser's microphone permission prompt. Disable active overlays, reopen HAPI, and grant microphone access again.
+
 ### Voice not responding
 
 - Verify the session is connected (green dot in status bar)