Deleting a Matter device in Home Assistant is quick, but it doesn’t remove the device from everywhere. Home Assistant asks the device to drop its connection to Home Assistant. Your other apps, and the device’s own memory, are separate. Here’s how to remove it cleanly.
Short answer
Go to Settings > Devices & services > Matter, select the device, open the three-dot menu, and choose Remove or Delete device. Do this while the device is online, if you can.
What deleting does
When you delete a Matter device, Home Assistant asks the Matter Server to remove its fabric from the device. A fabric is the device’s link to one controller. Home Assistant then removes the device’s entities.
Automations, scripts and dashboards that use those entities will break until you update them.
Matter devices can hold several fabrics. The spec requires support for at least five. Deleting in Home Assistant removes only Home Assistant’s fabric, so any other controllers keep their connection.
Remove the device from other controllers too
Removing a device from Home Assistant doesn’t remove it from Apple Home, Google Home, Alexa or SmartThings. Remove it in each app:
- Apple Home: open the accessory’s settings and choose Remove Accessory.
- Google Home: open the device’s settings and choose Remove device.
Some Home Assistant versions list the other fabrics on the device’s Matter info page, and let you remove them there. Whether that option appears depends on your version.
If the device is offline
If the device is offline when you delete it, Home Assistant forgets the device, but the device still holds the old fabric. The device keeps a stale record of Home Assistant’s fabric until you factory reset it.
Bring the device back online and delete it again if you can. If it won’t come back, factory reset it.
Factory reset to start fresh
A factory reset clears all of the device’s fabrics, so it’s the way to start completely fresh. The method depends on the manufacturer. Many devices need you to hold a button for about 10 seconds or longer, but check the product’s manual.
Deleting a device in Home Assistant doesn’t factory reset it. Deleting one entity isn’t the same as deleting the device, either.
Bridges and child devices
A Matter bridge, such as a Hue bridge or an Aqara hub, counts as a single node. If you delete the bridge, Home Assistant removes all of its child devices as well. Delete a bridge only if you’re sure you want everything behind it gone.
Re-adding the device
- After a factory reset, use the QR code or the 11-digit setup code on the device or its packaging.
- If the device is still paired with another controller, generate a new pairing code in that app instead.
- Thread devices don’t need any cleanup on the Thread network after removal.
If the device won’t pair again, see why a Matter device won’t pair with Home Assistant.
Troubleshooting removal errors
If removal fails, open Settings > Add-ons > Matter Server > Log. The log shows removal errors and tells you whether the device responded. For more on finding them, see how to find and read Home Assistant logs.
For the general model of devices and entities, see adding and managing devices in Home Assistant.