Matter - Home Assistant 2026.8.1 Getting started Documentation Installation Automations Dashboards Voice assistants Device organization Energy management Templating Configuration using the YAML file Our hardware Home Assistant Green Connect ZBT-2 Connect ZWA-2 Voice Preview Edition Integrations Blog Need help? On this page What does Thread have to do with Matter? Thread devices don’t necessarily support Matter Bluetooth used during commissioning Multi fabric: join to multiple controllers Supported installation types Adding a Matter device to Home Assistant Prerequisites To add a new device using the iOS Companion app To add a new device using the Android Companion app Troubleshooting the installation Sharing a device from another platform with Home Assistant Prerequisites To share a device from another Matter controller (like Apple or Google Home) Using a Matter bridge Sharing a device across platforms Removing a device from a Matter controller About Matter device information Matter OTA device updates List of actions Automate on a button press Experiment with Matter using a ESP32 dev board Troubleshooting Downloading diagnostics General recommendations I do not see the button Commission using the Companion app When trying to commission using Android, I get an error “Matter is unavailable” Android: stuck at “Checking network connectivity” Error “this device requires a border router” Error “Target node did not process the update file” Unable to commission devices, it keeps giving errors or stops working randomly Related topics Home ▸ Integrations Matter The Matter integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control Matter devices on your local Wi-Fi or ThreadThread is a low-power mesh networking standard that is specifically designed for smart home applications. It is a protocol that defines how devices communicate. [Learn more] network. For communicating with Matter devices, the Home Assistant integration runs its own “Matter controller” as an app (formerly known as add-on). This Matter Server app runs the controller software as a separate process and connects your Matter network (called Fabric in technical terms) and Home Assistant. The Home Assistant Matter integration connects to this server via a WebSocket connection. Introduction - What is Matter? Matter is a new smart home connectivity standard for home automation products and IoT (Internet of Things) devices, see its Wikipedia article. The initial version 1.0 release of Matter was published in October of 2022. Matter is still in the process of being adopted in the smart home market. It has gotten much publicity because of its promise of interoperability across all ecosystems. The largest tech companies like Google, Apple and Amazon teamed up to develop this new smart home connectivity standard under the roof of the CSA (Connectivity Standards Alliance). The largest tech companies that are already active in the home automation market have announced that they are or will be working on Matter-compatible products and also joined the development effort. Matter products run locally and always allow local control, with device control done without the need for any internet connection or cloud services. From a technical perspective, you can use a Matter-compatible device with Home Assistant without connecting to a vendor-specific cloud. However, some vendors may require you to set up an account before you can enable Matter support for some products, (especially for commercial manufacturer’s own branded gateways/bridges/hubs/controllers sold as appliances). Unlike other common radio-based protocols for IoT, (like Zigbee, Z-Wave, and Bluetooth), the Matter standard specification itself does not contain its own proprietary radio protocol or network transport protocol, but instead, it is a service control protocol that runs on top of the existing network infrastructure at the application level, with all Matter devices communicating using standard IP-based (IPv6) communication over your existing local area network (that is, LAN networks like Wi-Fi and Ethernet) or Thread (Low-Power Wireless Personal Area Network) depending on the type of device. Home Assistant is a so-called “controller” in a Matter ecosystem, meaning that it can control Matter-based devices. Other examples of Matter controllers are the Google Nest products, Apple HomePod speakers, Samsung SmartThings Station, and some newer Amazon Echo devices. What does Thread have to do with Matter? ThreadThread is a low-power mesh networking standard that is specifically designed for smart home applications. It is a protocol that defines how devices communicate. [Learn more] is a low power radio mesh networking technology. Much like Zigbee, but with the key difference that it is IP-addressable, making it a suitable transport protocol option for Matter. The figure below illustrates the landscape of MatterMatter is an open-source standard that defines how to control smart home devices on a Wi-Fi or Thread network. [Learn more], ThreadThread is a low-power mesh networking standard that is specifically designed for smart home applications. It is a protocol that defines how devices communicate. [Learn more], and Border routers. The Thread border router forwards traffic from the devices in the Thread network to devices outside that network. Image taken from the Thread Smart Home Fact Sheet by the Thread Group. For more information about Thread, refer to the Thread documentation. Thread devices don’t necessarily support Matter Many devices on the market use ThreadThread is a low-power mesh networking standard that is specifically designed for smart home applications. It is a protocol that defines how devices communicate. [Learn more] for radio communication and Matter as a control protocol. But this is not guaranteed. Some Thread-based devices support Apple HomeKit or another vendor-specific communication protocol. There are also a few cases where you need to apply for a (beta) firmware update on the device to enable Matter as a communication protocol. Don’t assume Matter support when you see a Thread logo on a device. Always look for the Matter logo itself (on either Wi-Fi/Ethernet-based devices or ThreadThread is a low-power mesh networking standard that is specifically designed for smart home applications. It is a protocol that defines how devices communicate. [Learn more]) or any other confirmation by the manufacturer that the device supports Matter. Bluetooth used during commissioning Most (if not all) Matter-compliant devices have a Bluetooth chip onboard to ease commissioningIn the context of Matter devices, commissioning is the process of adding a device to a Matter controller. It is the equivalent of pairing a device in Zigbee or Z-Wave. [Learn more]. Bluetooth is not used to control but to pair a device after unboxing or after factory resetting. The Home Assistant controller uses the Home Assistant Companion app for commissioningIn the context of Matter devices, commissioning is the process of adding a device to a Matter controller. It is the equivalent of pairing a device in Zigbee or Z-Wave. [Learn more]. During commissioning, you need to bring your phone close to the device. The controller then sends your network credentials to your device over Bluetooth. Once that is done, the device communicates over its native interface: Wi-Fi or Thread. Note Although your Home Assistant server might have a Bluetooth adapter on board that the controller can use to commissionIn the context of Matter devices, commissioning is the process of adding a device to a Matter controller. It is the equivalent of pairing a device in Zigbee or Z-Wave. [Learn more] devices, Home Assistant does not use that adapter. Mainly to prevent issues with the built-in Bluetooth integration but also because it is easier to bring your mobile devices close to the Matter device than bringing the device near your server. Multi fabric: join to multiple controllers One of the great features of Matter is the so-called Multi Fabric feature: you can join the same device to multiple controllers. For example, simultaneously add it to Google Home, Apple Home, and Home Assistant. The standard describes that each device should be able to at least support 5 different fabrics simultaneously. For devices where Home Assistant provides a native integration (with local API), Matter may not be the best option. Matter, being a universal standard, might not have the nitty-gritty features that come with a product-specific protocol. A good example is Philips Hue: the communication over Matter only provides the basic controls over lights, while the official Hue integration brings all Hue unique features like (dynamic) scenes or entertainment mode. Supported installation types It is recommended to run the Matter app (formerly known as Matter add-on) on Home Assistant OS. This is currently the only supported option. Other installation types are without support and at your own risk. If you run Home Assistant in a container, you can run a Docker image of the Matter server. The requirements and instructions for your host setup are described on that GitHub page. Adding a Matter device to Home Assistant Each Matter network is called a fabric. Each home automation controller that controls Matter devices has its own “fabric”. You can add devices directly to the fabric of your Home Assistant instance, or share them from another fabric (for example from Google or Apple) to Home Assistant’s fabric. We’re going to explore all these options below. Note: The section below mentions third-party Thread border routers such as the Nest Hub (2nd Gen) or the HomePod Mini. This doesn’t mean you have to add your devices to these ecosystems. Home Assistant only uses them to access the Thread radio network. The communication between the Home Assistant Matter controller and your Matter devices is encrypted. The Thread border router passes the data along. It cannot read its content. Prerequisites Make sure you have all these components ready before trying to add a Matter device to Home Assistant. Prepare Home Assistant Make sure you have the latest version of Home Assistant installed. In Home Assistant, have the Matter integration installed. Go to Settings > Devices & services. Add the Matter integration. When prompted to Select the connection method: If you run Home Assistant OS in a regular setup: select Submit. This will install the official Matter Server app for Home Assistant. Note that the official Matter Server app for Home Assistant is not supported on 32-bit platforms. If you are already running the Matter server in another Home Assistant app or a custom container: Deselect the checkbox, then select Submit. In the next step, provide the URL to your Matter server. Check logos on the device On the device packaging, check for both the Matter logo and for either the Wi-Fi or the ThreadThread is a low-power mesh networking standard that is specifically designed for smart home applications. It is a protocol that defines how devices communicate. [Learn more] logo. Check if the QR code or the numeric setup code is on the device. If you reset your device you’ll need the QR code or numeric setup code to commissionIn the context of Matter devices, commissioning is the process of adding a device to a Matter controller. It is the equivalent of pairing a device in Zigbee or Z-Wave. [Learn more] that device again! Without this information, commissioning won’t be possible. If the QR code or the numeric setup code is only in accompanied documentation, it is a good practice to snap a picture of the QR code and/or numeric setup code as a backup, ideally along with the device for reference, and store it in a safe place. Prepare Android or iPhone Have either an Android or iPhone ready and Bluetooth enabled. For information why Bluetooth is req…