- No Matter controller/hub in the ecosystem
- Hub 2 not on Matter-capable firmware
- Wrong or unreadable Matter setup code
Problem Description
Your SwitchBot Hub 2 supports Matter but you cannot add it to Apple Home, Google Home, or other Matter platforms. The QR code scan fails or the setup times out. You expected Matter to provide simple cross-platform setup but it does not work as advertised.
Why This Happens in Real Homes
The Hub 2 acts as a Matter bridge, exposing supported SwitchBot devices (like Curtain, Blind Tilt, Bot, and its own sensors) to Apple Home, Google, Alexa, or SmartThings — so Matter setup needs a Matter controller in that ecosystem, the Hub on Matter-capable firmware, and a solid 2.4GHz WiFi connection. Missing any of those stalls commissioning.
Confirm you have a Matter controller (a HomePod, Apple TV, Google/Nest hub, or SmartThings hub), update the Hub 2's firmware, and add it using the Matter setup code from the SwitchBot app while the controller is online. Keep the Hub on strong 2.4GHz WiFi and only expect Matter-supported SwitchBot devices to bridge. If your router blocks multicast/mDNS, enabling it lets the devices appear.
Symptoms
- Matter setup fails on the Hub 2
- Can't add the Hub to a Matter app
- Matter code rejected
- Devices don't appear in the Matter controller
- Pairs then drops
- Only some devices bridge
- Stuck adding to Apple/Google/Alexa
- Matter commissioning times out
Recognize these? Here's what usually causes it.
Common Causes
- No Matter controller/hub in the ecosystem
- Hub 2 not on Matter-capable firmware
- Wrong or unreadable Matter setup code
- Hub on 5GHz / weak WiFi
- Trying to bridge unsupported devices
- Controller offline during commissioning
- Too many Matter fabrics already added
- Router blocking multicast (mDNS)
Most fixes happen in the first 3 steps.
Not all SwitchBot devices are exposed through Matter. Check SwitchBot documentation for which devices can be controlled via Matter.
These tools will help you complete this fix.
As an Amazon Associate we earn from qualifying purchases.
Step-by-Step Solution
Enable Matter in SwitchBot App
Matter is not enabled by default. Open SwitchBot app and tap your Hub 2. Go to settings and find Matter Setup or Matter Bridge option. Enable it. This generates the Matter pairing code you need for setup.
Update Hub Firmware
Matter support was added in firmware updates. Go to Hub 2 settings in SwitchBot app and check for firmware updates. Install any available updates. Matter setup may fail on older firmware versions.
Check Network Configuration
Your Matter controller phone or hub and the SwitchBot Hub 2 must be on the same local network. Verify both are connected to the same WiFi network. Some routers have guest networks or IoT VLANs that prevent device discovery.
Verify Thread Border Router
If adding to Apple Home you need a Thread border router like HomePod mini or Apple TV 4K. Check Apple Home app to verify your border router is online. Without it Thread-based Matter devices cannot connect.
Reset Matter and Retry
If Matter was previously set up you may need to reset it. In SwitchBot app go to Hub 2 Matter settings and look for reset or unpair option. Reset Matter on the hub then scan the QR code fresh in your target platform.
Quick Solutions
Still having issues? This is usually the deeper cause below.
If the hub reconnects then drops every few minutes, check for an IP conflict — two devices sharing the same DHCP address fight each other continuously.
Matter allows multi-admin so the hub can be added to multiple platforms. But initial setup must succeed on the first platform before adding others.
Hub disconnections that cycle repeatedly are almost always IP conflicts — two devices fighting over the same DHCP lease after a router restart.
- No Matter controller/hub in the ecosystem
- Hub 2 not on Matter-capable firmware
- Wrong or unreadable Matter setup code
- Hub on 5GHz / weak WiFi
- Trying to bridge unsupported devices
Before you go — try one of these (they fix most cases).
Most popular upgrades chosen by SwitchBot Hub 2 owners.

SwitchBot Blind Tilt Automatic Blind Opener 3-Pack & Hub ...

SwitchBot Hub 2 (2nd Gen), work as a WiFi Thermometer Hyg...
As an Amazon Associate we earn from qualifying purchases.
Official Manufacturer Manual
If you need the complete manufacturer documentation for advanced setup, wiring diagrams, or detailed specifications, you can download the official manual below. The manual includes full technical instructions directly from the manufacturer and may help if your issue requires deeper troubleshooting.
Download the Official SwitchBot Hub 2 ManualSource: switch-bot.com
Need More Help? SwitchBot Support
Note: The contact information below connects you directly to SwitchBot's official customer support team, not Trunetto. They can help with warranty claims, device replacements, and advanced technical issues.
Accessories owners commonly pair with SwitchBot Hub 2.

Amazon Smart Plug, Works with Alexa, Simple Setup, Endles...

TP-Link WiFi Extender with Ethernet Port, Dual Band 5GHz/...

Kasa Smart Plug, Matter Compatible, Energy Monitoring, Co...
As an Amazon Associate we earn from qualifying purchases.






