Connecting > How-To > Matter (over) Thread

Applies to Matter over Thread Bulbs [A19, BR30, GU10, Downlights], Smart Matter Thread Lightstrips and Partner Products: Umbra Cono and Cup
 

Whether you're pairing for the first time or trying again after a failed attempt, we strongly recommend pairing in the Nanoleaf App FIRST before proceed with any 3rd party integration.  If you have already attempted to pair, and pairing failed, please reset your device.

Standard Pairing Instructions for Nanoleaf Devices:

• iOS

• Android

• Desktop

If a smart home hub and a compatible Thread Border Router are present in the home and detected by the Nanoleaf app, you will be provided with the option to connect your light to Matter.

Ready to Connect Using Matter Thread? Let’s Light Things Up.
🏠How-To: Connecting to An Ecosystem During Pairing
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

Continue with the following steps if you are presented with the Add To An Ecosystem screen:

✅ Tap the Connect button.

🍏On iOS, you will automatically be prompted to add the light to Apple Home.

🤖On Android, you will be shown a menu with the following:

Options for supported apps for direct pairing (select one and you’ll be directed through the setup flow in that app)

Option 1 - Use pairing code: Select this if the app you want to pair with is on the same phone/tablet but does not show up in the list.

Then, copy the code, and paste the code into the app you want to pair with (follow the more specific steps in the links below if you are having trouble).

Option 2 - Use QR code: Select this if the app you want to pair with is on a different phone/tablet, then open the app on your other device,

Then, scan the new QR code (follow the more specific steps in the links below if you’re having trouble).

Skipped the Step During Initial Setup? No Problem!
🏠How-To: Connecting to An Ecosystem After Pairing in the Nanoleaf App
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •

If you didn't connect a device to a smart home ecosystem during pairing, you can always do so through Device Settings in the Nanoleaf app.

• Tap on the device on the Dashboard to open the control view
• Next, tap on the settings button in the top right corner

Under the Connections section, you will be provided with the ability to connect your light to an ecosystem of your choice, OR messaging informing you that one of two things needs to happen:

⚡Message 1 - Disconnect and reconnect your device from power.

Proceed to do so. Once completed, exit and reopen the device settings and you should be presented with the ability to connect to an ecosystem. This step is required because Matter requires that pairing is only available for 15 minutes after a device is powered up for security reasons. 🔗Connecting > Troubleshooting > Not Connecting Using Matter (Matter Pairing Window Expired)

⚡Message 2 - It looks like you've paired this device before; follow the steps linked below to pair with a new ecosystem.

Go to the Ecosystem app to proceed to do so. In this case, we detected that you already have your lights paired to an ecosystem.

Matter's Multi-Admin feature requires that pairing be reactivated by an existing paired Matter controller, you will need to do this from whichever ecosystem you already have paired because the Nanoleaf app does not use Matter to communicate with Essentials. 

Directly Connecting to Pair
🏠How-To: Connecting Directly With An Ecosystem
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 

If you need to pair directly with one of the ecosystems, ensure the following requirements are met:

⭐ Smart home hub for selected ecosystem is already paired. 

⭐ Compatible Thread border router is paired (may be the same device as your smart home hub) | 🔗Resource: FAQ | Thread > Thread & Thread Border Routers (TBRs)

⭐ This is the first ecosystem you’re pairing your lights to. If you’ve already paired with one ecosystem via Matter and want to share with another, visit this resource: 🔗 How-To > Matter Multi-Admin: Using More than One Ecosystem

⭐ Pairing must be initiated within 15 minutes of the light being powered on. Disconnect and reconnect your lights from power to re-enable Matter pairing (this only works when the device has not already been paired via Matter).

Then, proceed to the  desired 3rd party setup resource for support on how to integrate into your preferred ecosystem:

🔗Apple Home  Instructions  ⚠️Pairing with Apple Home is only available on an iOS device

🔗Google Home Instructions

🔗Amazon Alexa Instructions

🔗Samsung SmartThings Instructions
 • • • • • • •
🆘 Need help? Submit a ticket using the form: Software Support > Connectivity Issues

NANOLEAF DISCLAIMER | Maintaining seamless integrations with smart home ecosystems is important to us, and we strive to ensure everything runs smoothly. However, some issues may arise that are beyond our control, such as platform-specific updates or compatibility changes made by third-party services. For the latest information and support on these external platforms, we recommend visiting their official help sites or contacting their support directly.

Keyword search: connect to smart home, connect to ecosystem, matter pairing, matter over thread, thread pairing, how to pair with ecosystem. smart home integration, Google Home, Alexa, Apple Home.