← All guides

Matter device not pairing? How to fix "pairing failed" on Apple Home, Google Home, Alexa, SmartThings and Home Assistant

Most Matter pairing failures come from a handful of causes — the device was already set up somewhere else (the code on the box only works for the first setup), a missing hub or Thread border router, the phone or network (Bluetooth off, wrong Wi-Fi band, IPv6, VLANs), or a device type the platform doesn't support at all. Check these before you factory reset.

Quick checks before anything else

1. Make sure the device is plugged in or fully charged, powered on, and in pairing mode according to the maker's instructions — Google, Amazon, and SmartThings all list this.
2. Was the device already set up in another app? Don't reuse the box code — get a new sharing code from the original app instead. See how to share a Matter device between platforms.
3. Confirm you have a hub or controller for this platform — Google requires a Matter-enabled hub, SmartThings requires a Matter Controller, and Apple recommends a home hub.
4. For Thread devices, make sure a Thread border router is present and online — Google and Home Assistant both call this out.
5. Turn on Bluetooth on your phone. Apple and Google require it (Google specifies BLE 4.2 or higher), and Home Assistant explains Bluetooth is used to pair, not to control.
6. Put your phone on the same Wi-Fi network as the device, and use 2.4 GHz for Wi-Fi Matter devices — Apple, Amazon, and Home Assistant all say this.
7. Enable IPv6 on your router. Google warns that without IPv6, setup may appear to succeed but control later fails.
8. Keep the device close during pairing — Alexa says within 30 ft (9 m), and Apple says to bring the accessory closer to the router.
9. Update your phone and the platform's app to the latest version — Apple and Google both list it.

What each platform needs before a device will pair

Every platform has a slightly different set of prerequisites — a hub, a Thread border router, phone requirements, or a specific app. Here's the short version:

For the full list of which hubs and Thread border routers each platform uses, see Do you need a Matter hub or Thread border router?

Does the platform support this kind of device at all?

Sometimes "pairing failed" isn't a network problem — the platform simply doesn't support that device type yet. Google's help page notes that all Matter-certified platforms update to support different device types at different times, so a device that pairs on one platform may not pair on another.

Apple's Home app currently supports these Matter accessory types: air conditioners, bridges, lights, locks, outlets, switches, thermostats, blinds and shades, and sensors (motion, ambient light, contact, temperature, and humidity).

MatterCheck tracks 24 Matter device types, and 16 of the 24 pair on all five platforms. The rest are uneven — some pair on only one or two platforms, some only partially. MatterCheck's confidence for each answer is in parentheses (how we rate it):

When a platform doesn't support a type, no reset or network fix helps. Developer reports on Apple's forums describe a Matter water valve being answered with "not supported" and the accessory not being created in Apple Home, while the same hardware presented as a plug pairs and works. Apple's own advice for a "not supported" alert is to install a firmware update — which only helps when the platform supports the type in the first place. Check water valve support, energy meter support, appliance support, the full platform comparison, or look up your device type.

Already set up in another app? Don't reuse the box code

This trips up a lot of people when adding a device to a second platform. Amazon's help says the Matter QR or pairing code on the device or packaging is only for initial setup or after a factory reset. If the device is already commissioned somewhere, that code won't work for adding it to another app.

Apple's Home app has a specific path for this: if your Matter accessory was previously paired to another app, tap More options and select your accessory instead of scanning the box code. SmartThings says its sharing code is different from the QR code physically on the device. Amazon's developer guidance notes that most customers don't realize they must first open the original app to generate a temporary code, and says a device can look "Ready to pair" yet still fail with "Pairing failed" or "This device is already commissioned" — a hidden "bound" state from prior commissioning is one of the common reasons it lists. For the exact steps in each app, see how to share a Matter device between Apple Home, Google Home, Alexa, SmartThings and Home Assistant.

Fix pairing in Apple Home

Apple's support pages cover the specific alerts you'll see in the Home app and what to do for each.

• No Add Accessory option — ask the Home Owner to edit your permissions in the Home app. The Home Owner must tap your name in Home Settings and turn on Add and Edit Accessories for you as a Resident (Apple).
• Already added alert — the accessory was already added to your home, or was previously used in another home. You may need to reset it; check the maker's manual or website (Apple).
• Unable to add to home — make sure the accessory is powered on, bring it closer to the router for setup, unplug third-party bridges and all home hubs (HomePod, HomePod mini, Apple TV) and plug them back in, then reset the accessory if needed (Apple).
• Network incompatible — check that your iPhone or iPad is on a 2.4 GHz Wi-Fi network; some accessories aren't compatible with 5.0 GHz (Apple).
• Not supported — the accessory may need a firmware update. Download the maker's app and install the latest firmware (Apple).
• Can't add a Matter accessory — set up a home hub. With iOS 18 or later you can add Matter accessories without one, but a hub is recommended for the best experience (Apple).
• Thread accessories — need a Thread-enabled home hub such as Apple TV 4K, HomePod (2nd generation), HomePod mini, or a compatible third-party border router. iPhone 15 Pro or later on iOS 18 can pair Thread accessories locally, which may require an update from the accessory maker (Apple).

Fix pairing in Google Home

Google's setup page lists the requirements and the specific fixes for a setup that stalls.

• Requirements — a Matter-enabled hub for Google Home, IPv6 enabled on your router, a Thread Border Router for Thread devices, Android 8.1+ or iOS 16.5+, BLE 4.2 or higher, and the latest Google Home app (Google).
• Setup freezes or doesn't finish — restart the Matter device, close the Google Home app, clear the Google Home app's cache, restart your phone, then try again. If it still fails, contact the device maker — a factory reset may be needed (Google).
• Set up in the maker's app but not in Google Home — accept the share prompt, or follow the maker's app instructions to share with Google Home (Google).
• Error adding from the maker's app — make sure you have a hub compatible with Google Home set up in the Google Home app (Google).

Google notes these instructions don't apply to Google Nest devices.

Fix pairing in Alexa

Amazon's troubleshooting page walks through first-time connection failures and what to check.

• Add path — in the Alexa app: Devices → the plus → Add Device → the matter icon → Yes → scan the QR code or enter the pairing code (Amazon).
• Restart first — unplug your Alexa device and the smart home device, plug them back in, and make sure the device is in pairing mode (Amazon).
• Network and range — Matter Wi-Fi devices must be on the same 2.4 GHz network as your compatible Matter controller, and within 30 ft (9 m) of it (Amazon).
• Thread devices — you need a Thread-enabled Alexa hub. If you don't have one, Amazon suggests setting up with another Thread-enabled voice assistant first, then connecting the device to Alexa (Amazon).
• No new devices found — the device may have connected automatically through Frustration-Free Setup; check under Devices in the Alexa app (Amazon).
• Still not working — install any available software updates, and as a last resort reset both your Alexa device and the smart home device (Amazon).

Fix pairing in SmartThings

SmartThings' Matter integration page has a dedicated section for devices that fail to onboard.

• My Matter device fails to onboard — SmartThings lists four steps: make sure you have a SmartThings or third-party Matter Controller; ensure the QR code is fully visible and the camera works (or use the setup code instead); check the device is in pairing mode and in range of both the phone and the Matter controller; reset the device using the maker's instructions and fully restart the SmartThings app (SmartThings).
• Five-service limit — each Matter device can only be connected to 5 different services. If it's already connected to 5, you'll need to remove it from one before sharing it again via multi-admin (SmartThings).

Fix pairing in Home Assistant

Home Assistant's Matter integration docs are the most detailed of the five, with specific remedies for each error message.

• You need to use the Home Assistant Companion app on your mobile phone to add Matter devices. — adding a Matter device only works in the Companion app, not in a browser. The Mac app can't add Matter devices; use an iPhone or iPad instead. Android requires version 8.1+ (12+ recommended) and the full Play Store version of the app (Home Assistant).
• Matter is currently unavailable on Android — wait up to 24 hours for Google Play Services to download the necessary Matter modules. Check Settings > Google > Devices & Sharing for a Matter devices entry. Reinstalling the Companion app helps, and (re-)installing the Google Home app might trigger another installation attempt (Home Assistant).
• Stuck at "Checking network connectivity" — meet the Android requirements, keep the phone close to the border router for Thread devices, and make sure the phone is on the same 2.4 GHz network for Wi-Fi devices (Home Assistant).
• this device requires a border router — set up a Thread border router and sync the Thread credentials from Home Assistant to your Android device (Home Assistant).
• Android Location permission — set the Companion app's Location permission to Allow all the time. Android restricts Wi-Fi SSID access for background apps otherwise, which can cause commissioning to fail (Home Assistant).
• IPv6 — IPv6 support has to be enabled on Home Assistant: in Settings > System > Network, set IPv6 to Automatic (or static, depending on your network; if unsure, use Automatic) (Home Assistant).
• Commissioning keeps failing — IPv6 multicast traffic must travel freely from your network to the Home Assistant host. Watch for VLANs, multicast filtering, malfunctioning IGMP snooping, and router settings that "optimize" multicast; keep the network flat (Home Assistant).

Network settings that break Matter pairing

Across all five platforms, the same network issues come up again and again. If pairing fails on multiple platforms or multiple devices, check these before blaming the accessory.

• IPv6 — Google says IPv6 must be enabled on your home network; Home Assistant says you don't need an IPv6 internet connection, but local IPv6 traffic has to flow.
• mDNS, multicast filtering, and IGMP snooping — Home Assistant says Matter relies on local IPv6 and mDNS (multicast) traffic moving freely, and may not work well with multicast filtering or malfunctioning IGMP snooping.
• VLANs and guest networks — keep the phone, hub, and device on one network. Apple says your iPhone, accessories, and home hubs must be on the same Wi-Fi network, and Home Assistant says to keep the network flat.
• 2.4 GHz vs 5 GHz — Matter devices often use 2.4 GHz for Wi-Fi, and some accessories aren't compatible with 5 GHz networks. Apple, Amazon, and Home Assistant all point you to 2.4 GHz.
• VPN and third-party security software — Apple says to check these for potential network connectivity issues.

When to factory reset (and what to have ready)

Four of the five platforms list a device reset as a later troubleshooting step — Apple, Google, SmartThings, and Amazon all include it. But before you reset, make sure you have the QR code or numeric setup code. Home Assistant says you'll need it to commission the device again, and suggests photographing the code as a backup. After a factory reset, the original code on the device works again — Amazon's help says the code is for initial setup or after a factory reset. Follow the maker's reset instructions for your specific device.

Paired, but now "No Response" or offline

If the device paired successfully but later shows No Response or goes offline, work through the platform's not-responding steps before you reset anything. Apple's troubleshooting page says to turn on Bluetooth, restart the accessory, check for a firmware update in the maker's app, restart bridges and home hubs, unplug Thread accessories for 5 minutes and wait 10 minutes for the Thread network to stabilize, then remove and re-add the accessory if needed. Apple also says to check VPN and third-party security software. Amazon says to disconnect the device in the Alexa app and set it up again. Home Assistant points back to the same network causes — IPv6, multicast filtering, and VLANs — when devices become unavailable randomly.

Frequently asked questions

Why does my Matter device say pairing failed?

The most common reasons are that the device was already commissioned to another platform (so the box code won't work), the commissioning window expired, the device isn't in pairing mode, or a network requirement like IPv6 or 2.4 GHz isn't met. Amazon's developer guidance lists hidden bound state, BLE advertising failures, misconfigured network settings, and expired commissioning windows as common causes.

Why won't my Matter device connect to Apple Home / HomeKit?

Check that the device type is one Apple Home supports, that you have a home hub (or iOS 18 without one), that Bluetooth is on, and that you're on 2.4 GHz. If the accessory was previously paired to another app, tap More options in the Home app instead of scanning the box code (Apple).

Why won't the QR code on my Matter device work?

If the device was already set up somewhere, the original QR code won't work for a second platform. Amazon says the code on the device is only for initial setup or after a factory reset. Generate a new sharing code from the original app instead.

Do I need IPv6 for Matter?

Yes. Google says IPv6 must be enabled on your home network: some Matter devices still work with IPv4, but without IPv6 setup may appear to succeed while control and other functions eventually fail. Home Assistant says you don't need an IPv6 internet connection, but local IPv6 traffic must flow freely.

Do I need a hub to pair a Matter device?

Usually, yes. Google requires a Matter-enabled hub, SmartThings requires a Matter Controller, and Alexa requires a Matter-enabled Echo or eero. Apple Home recommends a home hub, though iOS 18 or later can add Matter accessories without one. Home Assistant uses the Matter Server. See the hub and border router guide.

Why does Home Assistant say this device requires a border router?

That message means the device uses Thread, and there's no Thread border router near the device — or your phone doesn't have the Thread network credentials yet. Home Assistant says to set up a Thread border router and sync the Thread credentials to your Android device.

Can a reset fix a device my platform doesn't support?

No. If the platform doesn't support that device type, no reset or network fix will make it pair. Check the platform comparison or look up your device type before resetting anything.

More MatterCheck guides

• How to share a Matter device between platforms — the multi-admin steps for each app.
• Does Matter work without internet? — what keeps working offline on each platform.
• Matter bridges explained — how Zigbee, Hue, IKEA, Aqara and SwitchBot bridges work on each platform.
• Do you need a Matter hub or Thread border router? — which hubs and border routers each platform uses.
• Apple Home vs Google Home vs Alexa for Matter — which platform supports the most device types.
• Does Apple Home support Matter? — every device type checked.
• Does Google Home support Matter? — every device type checked.
• Does Alexa support Matter? — every device type checked.
• Does SmartThings support Matter? — every device type checked.
• Does Home Assistant support Matter? — every device type checked.

How we checked

The fixes on this page come from Apple, Google, Amazon, SmartThings, and Home Assistant's own support and developer pages, fetched 2026-10-19 (Apple pages dated 2026-03-03 to 2026-05-12; Home Assistant docs 2026.10.2). Which device types pair on which platform comes from the MatterCheck matrix v1.15 with its confidence levels. MatterCheck hasn't bench-tested every failure on every platform — see our methodology.

Last reviewed 2026-10-19. App menus and error wording change between updates; if a message differs, check the platform's own help page linked above.