- Matter not enabled on Hub 2 in SwitchBot app
- Hub firmware needs update for Matter
- Matter controller thread border router issues
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.
Symptoms
- Matter QR code scan fails
- Setup starts but times out before completing
- Hub not discovered by Matter controller
- Pairing completes but devices not visible
- Matter worked then stopped after update
- Can add to one platform but not another
Recognize these? Here's what usually causes it.
Common Causes
- Matter not enabled on Hub 2 in SwitchBot app
- Hub firmware needs update for Matter
- Matter controller thread border router issues
- Hub and controller on different networks
- Matter setup code already used on another platform
- SwitchBot devices not exposed to Matter
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.
- Matter not enabled on Hub 2 in SwitchBot app
- Hub firmware needs update for Matter
- Matter controller thread border router issues
- Hub and controller on different networks
- Matter setup code already used on another platform
Before you go — try one of these (they fix most cases).
Most popular upgrades chosen by SwitchBot Hub 2 owners.
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.







