Articles in this section

See more

Matter for Homey Pro (Early 2023)

  • Updated

This guide explains using Matter on Homey Pro (Early 2023).

Supported devices

Homey Pro (Early 2023) supports the Matter devices listed below. More devices will be added as they become available in the Matter specification and when products in that category are released. Homey Pro currently uses Matter 1.2, which is backward compatible with Matter 1.1 and Matter 1.0.

  • Bridges (only bridged devices of the types listed below can be used in Homey)
  • Buttons
  • Lights
  • Locks
  • Sensors (contact, light, occupancy, temperature, pressure, flow, or humidity)
  • Sockets
  • Thermostats
  • Window Coverings

Thread

Homey Pro can connect to Matter over Thread devices. For more information about Thread, refer to Thread for Homey Pro (Early 2023).

How to use Matter

Connecting a Matter device can be done using the Homey Web App and the Homey Mobile App. Here, we'll guide you through it.

There is no need to install apps for Matter devices
Homey Pro determines the device’s capabilities without installing any apps. However, Homey apps can enhance the experience for Matter devices in Homey.

The Homey Web App will connect Matter over Thread devices to Homey Pro’s Thread network. Matter over Wi-Fi devices will connect to the same Wi-Fi network as Homey Pro.

If Homey Pro is not connected to Wi-Fi and only uses the Ethernet connection, it is necessary to select a Wi-Fi network while connecting the Matter device manually.

Homey Web App

You can follow these steps to connect a Matter device through the Homey Web App.

Requirements
Ensure Homey Pro is updated to v10.3.0 or newer before connecting your Matter device.

Step 1

Go to https://my.homey.app and sign into your Homey account.

A web browser showing the login screen for the Homey Web App

Step 2

Once signed in, click on Circled plus icon → New Device in the upper-right corner.

A web browser showing the New Device option in the Homey Web App

Step 3

Click on Homey, then click on Matter.

A web browser showing the Technologies options in the Homey Web App

Step 4

Follow the on-screen instructions. If everything goes successfully, the Matter device will be added to Homey Pro. If not, please refer to Thread for Homey Pro (Early 2023) for more information.

Homey Mobile App

Using the Homey app, you can follow these steps to connect a Matter device.

Requirements
Ensure the Homey app is updated to v7.1.0 or newer and that your mobile device runs on iOS 16.5 or later or Android 8 or later.

Step 1

Open the Homey app and tap Devices in the tab bar.

A phone screen showing the home screen of the Homey app

Step 2

Tap Circled plus icon → New Device in the upper-right corner.

A phone screen showing the New Device option in the Homey app

Step 3

Tap Matter in the Technologies section.

A phone screen showing the Technologies section in the Homey app

Step 4

Follow the on-screen instructions. The first connection screen will ask you to either “Connect via Homey Pro” or “Connect via Android/iOS.” The difference is which Thread network is used for Matter over Thread devices.

A phone screen showing the connection options for Matter devices

  • Connect via Homey Pro: This option is advised for most users, as it always uses Homey Pro’s own Thread network.
  • Connect via Android/iOS: This option uses the Thread network configured on the mobile device to connect to the Matter device.

If everything goes successfully, the Matter device will be added to Homey Pro. If not, please refer to Thread for Homey Pro (Early 2023) for more information.

Known issues

Some Android devices cannot pair with Matter devices even though the supported Android and Google Play Services versions are installed. Note that the Matter API of Google Play Services can take up to 24 hours to update.

Related articles