
Pairing a Matter-over-Thread device
To connect a device, open the Homey app, tap “Add device,” and select Matter. Scan the device’s QR code or enter its setup code. Homey then uses Bluetooth for secure onboarding, a process called commissioning.
During commissioning, Homey and the device exchange keys, verify identities and establish whether the connection will use Thread or Wi-Fi. For Matter-over-Thread devices, Homey’s built-in Thread Border Router functionality brings the device into the mesh. It then appears in Homey with its supported capabilities, such as motion detection or energy monitoring.
How the onboarding route affects the network
The Homey Web App always adds Matter-over-Thread devices to the Thread network managed by your Homey Pro or Homey Pro mini. In the Homey Mobile App, choosing between Homey Pro and Android/iOS determines which Thread network the device joins.
Either route adds the device to your Homey smart hub, with Homey acting as its controller. Homey provides Thread Border Router functionality to bridge the device to the local network, although network ownership and the particular border router used can vary with the onboarding route. The security model remains the same; the commissioning pathway and Thread fabric differ.
Using Thread devices in Flows
After pairing, devices work according to their capabilities rather than requiring protocol-specific handling. Motion and contact sensors fit into Flows and Advanced Flows alongside existing Zigbee, Z-Wave and Wi-Fi equipment.
A Thread motion sensor typically exposes a motion alarm and battery level. It could trigger a Wi-Fi or Zigbee light after sunset. Other cross-protocol routines can pause heating when a Z-Wave balcony contact sensor opens.
Matter defines how devices describe their features, while Thread carries communications. This lets Homey combine supported devices in unified Flows. However, standardization does not make every device identical: Homey focuses on Matter devices and clusters that fit its capabilities model, and unsupported clusters may not yet map cleanly.
Sharing devices between platforms
Matter’s Multi-Admin feature lets independent controllers pair with and control the same device. A Thread smart plug, for example, can appear in Homey, Apple Home and Google Home simultaneously. Once added to both systems, each can control it independently.
Homey can remain the main automation platform while shared devices are also accessible through a preferred voice assistant. Its roles as Matter controller and Thread Border Router allow it to connect technologies and vendors without requiring exclusive use of one ecosystem.
Thread smart plugs and Homey Energy
When paired with Homey, Matter-over-Thread smart plugs join the Thread mesh and report their on/off state. Many also provide real-time power measurements.
In Homey Energy, they appear beside devices using other protocols. You can compare consumption with Zigbee and Z-Wave plugs, track individual appliances or automate non-smart equipment. Flows can switch plugs according to energy tariffs, solar production or time-of-day schedules. The plugs can also be shared through Homey to Apple Home, Google Home or Alexa.
Thread smart plugs combine long-term ecosystem compatibility, low energy use and stable communication. In everyday use, they become ordinary parts of the Homey setup, contributing to Energy and triggering Flows like other connected equipment.
Local control and troubleshooting
Day-to-day operation does not require attention to the underlying protocol. Its main implications are power consumption and RF design; Homey abstracts the rest. Matter is designed for local control, so Thread traffic and Matter commands between Homey and the device remain within the home network.
A connection problem may appear in Homey as an intermittent or offline device. As with Zigbee or Z-Wave, troubleshoot in this order: improve RF conditions, choose unobstructed placement, add routers and update firmware.
Moving a device from another controller is possible, but may require a factory reset or removal from the previous controller before commissioning it again with Homey.
Matter terminology
- Matter controller
- A device or application that commissions, configures and controls Matter devices. Homey Pro and Pro mini serve this role.
- Commissioning
- Secure onboarding, including QR code scanning, key exchange and network assignment.
- Matter QR code
- A printed device code containing setup information, including the setup code used to start secure commissioning.
- Cluster
- A group of attributes and commands describing a feature, such as an On/Off cluster or Level Control cluster.
- Multi-Admin
- A Matter feature that lets several independent controllers pair with and control one device.
- Fabric
- A Matter security and configuration domain. Devices may belong to multiple fabrics, each managed by one or more controllers.
- Fabric identifier
- An identifier that tells controllers and devices which logical home or administrative domain a relationship belongs to.
- Endpoint
- A logical device instance within a physical product. One product can contain several endpoints, such as multiple switches, each with its own clusters.