Troubleshooting

Matter over Thread device unavailable in Home Assistant

Recovery checklist for Matter over Thread devices that suddenly become unavailable in Home Assistant.

Home AssistantGoogle HomeApple Home

Short answer

Matter over Thread devices usually become unavailable because the Thread Border Router is offline, the phone or controller moved credentials to another Thread network, mDNS or IPv6 discovery is blocked, or the Matter Server cannot reach the active fabric.

Next step

Symptoms this page covers

  • Device dropped offline
  • No border router found
  • Unavailable after router or hub change
  • Works in one ecosystem but not another

Likely causes

  • The active Thread Border Router is offline or changed.
  • Multiple Thread networks exist and the device is on a different one.
  • Network changes blocked IPv6, multicast, or mDNS discovery.
  • Home Assistant Matter Server is running but cannot reach the controller path.

Fix checklist

  1. Identify which Thread Border Router the device was originally commissioned through.
  2. Confirm that hub is online before changing Home Assistant settings.
  3. Check Home Assistant Thread and Matter diagnostics before resetting the device.
  4. Restart Matter Server only after confirming the network path.
  5. If Google Home or Apple Home still controls the device, use that as a clue for the active Thread network.

Avoid these mistakes

  • Do not reset all Thread devices when only the border router path changed.
  • Do not delete a working ecosystem fabric before exporting or recreating a multi-admin path.
  • Do not assume Wi-Fi router changes are unrelated; IPv6 and multicast changes can affect Matter.

FAQ

Should I factory reset Matter over Thread devices first?

Usually no. First confirm the controller, hub, network, and integration path. Resetting too early can remove useful evidence about which ecosystem or Thread network currently owns the device.

Do I need a Thread Border Router?

You need a Thread Border Router when the device is Matter over Thread or otherwise uses Thread. A Matter Controller is not always a Thread Border Router, so verify the exact hub role before pairing.

Does Matter expose every feature and entity?

Not always. Matter often exposes standard controls, while advanced settings, vendor-specific features, and some bridged child entities may remain available only through the vendor app or another integration path.

What should I check before buying another hub?

Check whether you already have the required Matter Controller, Thread Border Router, vendor hub, Zigbee coordinator, and Home Assistant service. Use the linked calculator or diagnostic tool before purchasing extra hardware.

Can SmartHomeCompat guarantee this fix for Home Assistant?

No. These pages are based on official docs, product information, public compatibility data, and community issue patterns. They are designed to narrow the likely setup path and reveal missing pieces.

Feedback

Help improve this compatibility data

Smart home compatibility changes quickly. Send a report, request a missing device, or flag information that needs another review.