Skip to content

Clarification on the method of adding the Switchbot device in BLE integration #41938

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
c0ffeeca7 merged 2 commits into from
Dec 16, 2025
Merged

Clarification on the method of adding the Switchbot device in BLE integration #41938

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
51c586e
fix
zerzhang Nov 24, 2025
4edb39e
tiny tweak
c0ffeeca7 Dec 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions source/_integrations/switchbot.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,24 @@ 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
Comment thread
c0ffeeca7 marked this conversation as resolved.

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

Expand Down