Pairing your Essentials (Matter) lightsUpdated 4 months ago
We strongly recommend pairing your lights in the Nanoleaf app first as we are able to ensure that this is the smoothest experience possible for getting access to Nanoleaf-exclusive features and firmware updates. We also provide a slick handoff to supported smart home ecosystems via Matter.
Pairing with the Nanoleaf app
On the Dashboard, tap the pencil icon in the top right corner.
Tap “Add Device +”.
Select the Essentials tab and then “Start Scan” on the model being paired.
Tap the Pair button on the device you want to pair with.
The magnifying glass can be used to flash the device to identify it. This is disabled 15 minutes after the light is powered up for security.
If you don’t want to flash the device, the three characters at the end of the device name can be matched up with the characters next to “ID:” printed on your light near the Matter code as well as on the front of the quick start guide.
Scan the Matter QR code on the light or on the quick start guide. Alternatively, select Pair Manually, input the 11 digit pairing code, and tap Next.
The Nanoleaf app will pair with the device and ask you for permission to access your network to check for available Thread networks, and then provision the device to Thread if one is available.
Name your device and assign it to a room.
If a smart home hub and 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. Otherwise, you will be taken back to the Dashboard. Continue with the following steps if you’re 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)
“Use pairing code” - select this if the app you want to pair with is on the same phone/tablet but doesn’t show up in the list, 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’re having trouble).
“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 and scan the new QR code (follow the more specific steps in the links below if you’re having trouble).
Connecting using Matter after pairing in the Nanoleaf app
If you don'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, then tap on the settings button in the top right corner. Under the Connections section you'll be provided with either the ability to connect your light to an ecosystem of your choice, or messaging informing you that one of two things needs to happen:
- "Disconnect and reconnect your device from power." Once you've done so, exiting and reopening device settings should present you 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.
- "It looks like you've paired this device before; follow the steps linked below to pair with a new ecosystem." In this case, we detect 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, and because the Nanoleaf app doesn't use Matter to communicate with Essentials, you'll need to do this from whichever ecosystem you already have paired. We centralized instructions for each one here for your convenience.
Pairing directly with an Ecosystem
If you need to pair directly with one of the ecosystems, ensure the following requirements are satisfied:
Smart home hub for that ecosystem is already paired
Compatible Thread border router is paired (may be the same device as your smart home hub), see this list for details
This is the first ecosystem you’re pairing your Essentials to. If you’ve already paired with one ecosystem via Matter and want to share with another, follow the steps here
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 with the following steps in the links below for your desired ecosystem:
Pairing with Apple Home is only available using an iOS device.