From 51c586eb09f3d44ef462615cfb049fec8d9882e2 Mon Sep 17 00:00:00 2001
From: zerzhang <916250497@qq.com>
Date: Mon, 24 Nov 2025 19:02:17 +0800
Subject: [PATCH 1/2] fix

---
 source/_integrations/switchbot.markdown | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/source/_integrations/switchbot.markdown b/source/_integrations/switchbot.markdown
index 06c334f7a3d1..068fb92038ca 100644
--- a/source/_integrations/switchbot.markdown
+++ b/source/_integrations/switchbot.markdown
@@ -63,7 +63,23 @@ Please note, device names configured in the SwitchBot app are not transferred in
 
 Some SwitchBot devices need to be configured within the app before being controlled by Home Assistant, such as calibrating the cover open/close limits or pairing two covers to move together.
 
+### Add mode
+Before adding SwitchBot devices over Bluetooth, confirm whether your Bluetooth adapter is set to *Active* or *Passive* mode in the Bluetooth integration configuration.
 
+- To open the Bluetooth integration settings, go to {% my integrations title="**Settings** > **Devices & services**" %} and select **Integrations**, then find and open the **Bluetooth** integration to check the adapter mode.
+
+- Active mode
+  - Devices are normally discovered automatically.
+  - If a device is not discovered automatically:
+    - For devices with a physical button, press and hold the button to enter pairing mode.
+    - For devices without a button, power-cycle the device to trigger pairing mode.
+    - If the device still cannot be discovered, try syncing devices from your SwitchBot account by selecting  the **SwitchBot** integration and signing in.
+
+- Passive mode
+  - Devices cannot be discovered via local Bluetooth scanning and must be synchronized through your SwitchBot account.
+  - To sync devices from your account, go to {% my integrations title="**Settings** > **Devices & services**" %}, open **Integrations**, select **SwitchBot**, select  the integration to open the login window, and sign in. If the local Bluetooth scan detects devices that are linked to your SwitchBot account and within range, you can add them after signing in.
+
+If you still cannot add a device, make sure it is powered on, within Bluetooth range, and not connected to another app. If necessary, follow the manufacturer's reset instructions or consult SwitchBot support.
 
 ### Adding encrypted SwitchBot devices
 

From 4edb39e63b46e264f132463aed9ca77283a607dc Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Tue, 16 Dec 2025 07:45:51 +0100
Subject: [PATCH 2/2] tiny tweak

---
 source/_integrations/switchbot.markdown | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/source/_integrations/switchbot.markdown b/source/_integrations/switchbot.markdown
index 068fb92038ca..dbd78821a697 100644
--- a/source/_integrations/switchbot.markdown
+++ b/source/_integrations/switchbot.markdown
@@ -64,7 +64,8 @@ Please note, device names configured in the SwitchBot app are not transferred in
 Some SwitchBot devices need to be configured within the app before being controlled by Home Assistant, such as calibrating the cover open/close limits or pairing two covers to move together.
 
 ### Add mode
-Before adding SwitchBot devices over Bluetooth, confirm whether your Bluetooth adapter is set to *Active* or *Passive* mode in the Bluetooth integration configuration.
+
+Before adding SwitchBot devices over Bluetooth, confirm whether your Bluetooth adapter is set to **Active** or **Passive** mode in the Bluetooth integration configuration.
 
 - To open the Bluetooth integration settings, go to {% my integrations title="**Settings** > **Devices & services**" %} and select **Integrations**, then find and open the **Bluetooth** integration to check the adapter mode.