SwitchBot Hub and Matter Setup and Troubleshooting
Most SwitchBot devices, such as the Bot, Curtain, Blind Tilt and Lock, talk over Bluetooth. A SwitchBot hub is what puts them on Wi-Fi, so you can reach them away from home, use them with voice assistants and, with the Hub 2, Hub 3 or Hub Mini Matter Enabled, share them with Apple Home, Google Home or SmartThings over Matter. When the hub drops off Wi-Fi, everything behind it goes offline too. This guide follows SwitchBot’s own help center for setup, Wi-Fi fixes, Matter pairing and resets.
Affiliate disclosure: As an Amazon Associate, Everyday Tech Guide earns from qualifying purchases. This page contains labeled affiliate links; we may earn a commission if you purchase through them, at no additional cost to you. Our picks are not paid placements.
Quick answers
- Hub won’t connect to Wi-Fi? SwitchBot hubs need 2.4 GHz Wi-Fi; 5 GHz isn’t supported. Use WPA-PSK or WPA2-PSK security, not WPA2-PEAP, WPA3-PEAP, WEP or WPS (SwitchBot: Hub Mini setup and router settings, SwitchBot: Hub Mini fails to connect to Wi-Fi).
- Can’t add it to Apple Home? You need a HomePod mini or Apple TV as a home hub, all on the same 2.4 GHz network. If pairing stalls, turn on mDNS on your router (SwitchBot: Unable to add Hub 2 to Apple Home).
- Adding to Google Home or Apple Home over Matter? Reset the Hub 2 or Hub 3 first: hold the On and Off buttons together for 15 seconds (SwitchBot: Hub 2 Matter setup (Android), SwitchBot: Hub 3 Matter setup (iOS)).
- Bluetooth device keeps going offline? Check the hub’s Wi-Fi first, then move the device closer to a hub (SwitchBot: Bluetooth devices disconnect from hubs).
How to set up a SwitchBot Hub 2
SwitchBot’s steps (SwitchBot: How to set up Hub 2):
- Update the SwitchBot app.
- Connect your phone to a 2.4 GHz Wi-Fi network.
- Power on the Hub 2.
- In the app, tap “+” in the top right, then “Add Device”, and choose Hub 2 under “Hub”.
- Press and hold the On and Off buttons on the Hub 2 screen together for 2 seconds.
- Enter your Wi-Fi name (SSID) and password, save, then tap “Finish”.
For the Hub Mini, SwitchBot says to allow Bluetooth and location access for the app, choose “Hub Mini” in Add Device, and hold the button on top until the light flashes before entering your Wi-Fi details (SwitchBot: Hub Mini setup and router settings). For the Hub 3, follow the in-app Add Device steps; Amazon’s listing reminds you to keep it on 2.4 GHz and to pick the 2.4 GHz band manually on dual-band routers if setup fails.
Fixing SwitchBot hub Wi-Fi connection failures
SwitchBot’s checklist for a hub that won’t connect or keeps dropping (SwitchBot: Hub Mini setup and router settings, SwitchBot: Hub Mini fails to connect to Wi-Fi):
| Check | What SwitchBot says |
|---|---|
| Wi-Fi band | Use 2.4 GHz only. Mesh systems that combine bands usually connect at 2.4 GHz, but some routers push devices to 5 GHz. Repeaters should mainly use 2.4 GHz. |
| Security type | WPA-PSK or WPA2-PSK is recommended. WPA2-PEAP, WPA3-PEAP, WEP and WPS aren’t supported. |
| Router features | Turn off MAC address filtering. Make sure DHCP gives the hub an IP address automatically. Check firewall settings; the hub uses MQTT over TCP port 8883. |
| Power | Use a 5V 1A or 5V 2A adapter. Low-power USB ports and poor cables can cause unstable behavior; try a different adapter and cable. |
| Signal | A weak signal can cause drops or slow responses. Move the hub closer to the router, and do setup near the router. |
| IP address problems | Unplug both the router and the hub, wait 10 minutes, then reconnect them. |
| Wi-Fi details | Re-enter the network in the app (hub, gear icon, Wi-Fi Settings, Edit). If your network isn’t listed, type the SSID manually. |
| Firmware | Update the hub and the router firmware. If the hub can’t join your Wi-Fi, connect it to your phone’s hotspot to update, then move it back. |
Our note: if your router uses one name for both bands and you can’t separate them, many routers let you add a 2.4 GHz-only IoT network. See our IoT network guide for the trade-offs.
Adding a SwitchBot hub to Apple Home
SwitchBot’s Hub 3 steps, which match the Hub 2 (SwitchBot: Hub 3 Matter setup (iOS), SwitchBot: Matter bridge devices on third-party platforms):
- Make sure the hub is already in the SwitchBot app and its firmware is current.
- Put your iPhone, HomePod or Apple TV, and the hub on the same 2.4 GHz network.
- Copy the Matter code from the SwitchBot app: your hub, gear icon, Matter Setup.
- Reset the hub by holding On and Off for 15 seconds. On the Hub 2, the panel lights go out, then come back with a slow-flashing light: that’s Matter setup mode.
- In Apple Home, tap “+”, Add Accessory, More options, “My Accessory Isn’t Shown Here”, Enter Code, and paste the code. You can also scan the QR code on the back of the hub.
- Back in the SwitchBot app, use Matter Setup, Add secondary devices, to share your other SwitchBot devices.
| Problem | SwitchBot’s fix (SwitchBot: Unable to add Hub 2 to Apple Home) |
|---|---|
| “Home Hub Required” | Set up a HomePod mini or Apple TV as a home hub. |
| Hub light flashing slowly and it won’t add | Turn on Bluetooth on your phone and try again. If there’s no Matter code on the back, tap “My Accessory Isn’t Shown Here” and enter the code. |
| “Unable to Connect” with the hub light on | Turn on mDNS on your router (check your router maker’s instructions). |
| Can’t enter the 11-digit code | Update iOS to 16 or later. |
| Home hub on a different network | Put the hub, iPhone and HomePod or Apple TV on the same 2.4 GHz network. |
| iCloud Keychain off | Turn it on in Settings, your Apple ID, iCloud, Keychain. |
Adding a SwitchBot hub to Google Home, Alexa or SmartThings
Google Home: you need a Google Matter controller such as a Nest Hub, with the phone, Nest device and hub on the same 2.4 GHz network. Copy the Matter code from the SwitchBot app, reset the hub (On and Off for 15 seconds), then in Google Home tap Add, “Matter-enabled device”, and paste the code or scan the QR code on the back (SwitchBot: Hub 2 Matter setup (Android)). SwitchBot says the Hub 2 can share up to 8 secondary devices this way; the Hub 3 can sync up to 30 to Apple Home (SwitchBot: Hub 3 Matter setup (iOS)).
SmartThings: with a Matter-capable Samsung hub online, get the pairing code from the device’s Matter Setup page in the SwitchBot app, then in SmartThings tap “+”, Add device, Partner devices, Matter (SwitchBot: Matter bridge devices on third-party platforms).
Alexa: Amazon’s listing says the hubs work with Alexa. SwitchBot doesn’t give a separate Alexa Matter guide on the pages we used, so follow the in-app steps in the SwitchBot app.
When Bluetooth devices drop off the hub
If a Bot, Curtain or Lock shows offline, SwitchBot suggests (SwitchBot: Bluetooth devices disconnect from hubs):
- Check the hub’s light. A steady light means power is fine; a slow-flashing white light means the hub is trying to connect to the network. If you turned the light off, turn it back on in settings to check.
- Open the hub’s Wi-Fi settings. If the connection looks unstable, tap Edit and connect it to another 2.4 GHz network.
- Go to Profile, Manage Hubs to see which hub can find the device. Closer hubs usually have better coverage; refresh the list if the device is missing.
- Move the device and hub closer, away from metal and electronics, and make sure the device has power.
With more than one hub, assign each Bluetooth device to the hub nearest to it.
How to reset a SwitchBot Hub 2 or Hub 3
Press and hold the On and Off buttons on the display together for 15 seconds (SwitchBot: How to reset Hub 2, SwitchBot: Hub 3 Matter setup (iOS)). On the Hub 2, SwitchBot says this resets the Wi-Fi details and indicator light settings to defaults, but keeps logs, learned infrared remotes, and scenes and automations (SwitchBot: How to reset Hub 2). This is also the step SwitchBot asks for before adding the hub to Apple Home or Google Home over Matter.
On the Hub Mini, holding the button on top until the light flashes puts it into setup mode for re-entering Wi-Fi details (SwitchBot: Hub Mini setup and router settings).
SwitchBot hubs mentioned in this guide
Details come from SwitchBot’s help center and Amazon listings. When we checked on October 23, 2026, both were in stock as new items sold by SwitchBot US, SwitchBot’s own store on Amazon, and shipped by Amazon.
SwitchBot Hub 2 (W3202100)
Connects SwitchBot Bluetooth devices to 2.4 GHz Wi-Fi, learns infrared remotes, and works as a Matter bridge for Apple Home and Google Home, with up to 8 secondary devices in Google Home (SwitchBot: Hub 2 Matter setup (Android)). The listing says a 5V 2A adapter and a 2 m temperature and humidity cable are in the box.
View the SwitchBot Hub 2 on Amazon (affiliate link) →
We have not independently tested this product. Availability, specifications and platform support can change; confirm the details on the product listing and the manufacturer's site.
SwitchBot Hub 3 (W7202100)
SwitchBot’s newer hub, with a screen, a dial and scene buttons. It is a Matter bridge that can sync up to 30 secondary devices to Apple Home (SwitchBot: Hub 3 Matter setup (iOS)). The listing notes it controls infrared appliances only, not RF devices such as many ceiling fans, and needs 2.4 GHz Wi-Fi.
View the SwitchBot Hub 3 on Amazon (affiliate link) →
We have not independently tested this product. Availability, specifications and platform support can change; confirm the details on the product listing and the manufacturer's site.
Frequently asked questions
Why won’t my SwitchBot hub connect to Wi-Fi?
Usually it’s trying to join 5 GHz or an unsupported security type. SwitchBot hubs need 2.4 GHz with WPA-PSK or WPA2-PSK. Also check MAC filtering, DHCP, the firewall and the power adapter.
Does SwitchBot Hub 2 work on 5 GHz Wi-Fi?
No. SwitchBot says its hubs need a 2.4 GHz network. On dual-band routers that share one network name, choose 2.4 GHz manually or set up a 2.4 GHz network.
How do I reset a SwitchBot Hub 2?
Hold the On and Off buttons on the display together for 15 seconds. Wi-Fi details and light settings reset; learned IR remotes, logs and scenes stay.
Why does Apple Home say “Home Hub Required”?
Matter in Apple Home needs a HomePod mini or Apple TV set up as a home hub on the same 2.4 GHz network as the SwitchBot hub.
My SwitchBot hub won’t finish adding to Apple Home. What else can I try?
SwitchBot suggests turning on mDNS on your router, turning on Bluetooth and iCloud Keychain, and entering the code manually through “My Accessory Isn’t Shown Here”.
How many SwitchBot devices can I share over Matter?
SwitchBot gives up to 8 secondary devices through Hub 2 in Google Home, and up to 30 through Hub 3 in Apple Home.
Why does my SwitchBot Bot or Curtain show offline?
These devices use Bluetooth and reach the internet through a hub. Check the hub’s Wi-Fi, then make sure a hub is close enough to see the device under Profile, Manage Hubs.
Can a SwitchBot hub control ceiling fans?
Only if they use infrared remotes. Amazon’s Hub 3 listing says it doesn’t support RF devices such as many ceiling fans and garage door openers.