Search guides

Fix a Matter device that will not pair

We'll check the Thread border router, bring the device close, and put the controller in pairing mode—so the Matter device pairs or we tell you when to call support.

Troubleshooting · Home maintenance
10–25 min
What you'll need
  • Matter controller (hub, phone, or smart speaker)
  • Thread border router (if device uses Thread)
  • App for the controller
Step 1 of 6

Quick triage — pick your path

Quick triage — pick your path

Choose the option that matches what you see. You can jump straight to that section.

Show full guide

Steps

Goal: Confirm device type, check the border router or router, then commission the device.

  • Confirm whether the device uses Matter over Thread or Wi‑Fi.
  • Good: You know the type. Proceed to Thread path or Wi‑Fi path.
  • Bad: Check the device specs or box.

Thread path

Goal: Check the Thread border router and pair the device.

  • Confirm the border router is on and connected to Wi‑Fi. Restart it if needed.
  • Bring the device within 10–15 feet. Put the controller in pairing mode. Scan the QR code or enter the pairing code.
  • Confirm the device commissions and appears in the app.

Wi‑Fi path

Goal: Check the router and pair the device.

  • Confirm the router is on. Bring the device within 10–15 feet.
  • Put the controller in pairing mode. Scan the QR code or enter the pairing code.
  • Confirm the device commissions and appears in the app.

When to get help

  • Call the manufacturer if the device still will not pair after checking the border router, bringing it close, and factory reset.

Verification

  • The device appears in the app and shows connected.
  • The device responds to commands.
  • No offline or pairing errors.

Escalation ladder

Work from the device outward. Stop when the problem is fixed.

  1. Confirm device type Check if Matter over Thread or Wi‑Fi.
  2. Border router (Thread) Confirm border router is on and connected.
  3. Bring device close Within 10–15 feet during pairing.
  4. Pairing mode Put controller in pairing mode, scan QR or enter code.
  5. Call support Manufacturer for faulty or incompatible device.

What to capture if you need help

Before calling support or posting for help, have these ready. It speeds everything up.

  • Device model and connection type
  • Whether border router was checked (Thread)
  • Steps already tried

Does the device use Thread or Wi‑Fi?

Check the device specs or box.

Check if Matter over Thread or Wi‑Fi. Thread: need Thread border router. Wi‑Fi: need router. Match your setup.

Thread Wi‑Fi

You can change your answer later.

Is the border router on and connected?

Thread devices need a border router.

Check the Thread border router is powered on and connected to Wi‑Fi. Restart it if needed. Good: border router online. Bad: border router off—power on and retry.

Yes No

You can change your answer later.

Fix border router

Power on the border router. Connect to Wi‑Fi. Restart if needed. Retry commission.

Done

Is the router on?

Wi‑Fi Matter devices need the router.

Confirm the router is on and the device can reach it. Good: router online. Bad: router off—power on and retry.

Yes No

You can change your answer later.

Fix router

Power on the router. Retry commission.

Done

Commission the device

Bring device within 10–15 feet. Put controller in pairing mode. Scan QR or enter code. Commission the device. If still fails, factory reset and retry, or call support.

Done

Reviewed by Blackbox Atlas

Frequently asked questions

Why would a Matter device not pair?
Common causes: no Thread border router for Thread devices, device too far from the hub, controller not in pairing mode, or a faulty device. Check the border router and bring the device close first.
What is a Thread border router?
A device that connects Thread (low-power wireless) to your Wi‑Fi network. Many smart speakers, hubs, and displays act as border routers. Matter-over-Thread devices need one to pair.
Does Matter use Wi‑Fi or Thread?
Matter supports both. Wi‑Fi Matter devices connect directly to your router. Thread Matter devices connect through a border router. Check your device specs to know which it uses.

Rate this guide

Was this helpful?

Continue to