Short Answer: Yes, But Pick the Right Nanoleaf Path
You can use Nanoleaf Matter lights with Home Assistant without making Apple Home the owner. For a current Nanoleaf Essentials Matter-over-Thread bulb, BR30 bulb, downlight, or Matter lightstrip, the normal path is Home Assistant's Matter integration plus a working Thread border router. For a current Nanoleaf Matter-over-Wi-Fi A19 bulb, the normal path is Home Assistant's Matter integration over Wi-Fi, with no Thread border router required for the light itself.
The confusing part is older Nanoleaf Essentials hardware. Home Assistant's official Nanoleaf integration controls Nanoleaf Light Panels, Canvas, Shapes, Elements, and Lines. It explicitly does not support Essentials lights. Home Assistant says Essentials lights can be controlled through the HomeKit Device integration over Thread or Bluetooth, which is a different path from Matter.
In plain English: Thread is the low-power mesh radio. Matter and HomeKit are control languages. A Thread Nanoleaf light is not automatically a Matter Nanoleaf light. Before you buy or reset anything, identify the exact generation and protocol on the product page, box, QR code, and app.
Tara's rule: let Home Assistant own the lighting automations. Use Apple Home, Google Home, Alexa, SmartThings, or the Nanoleaf app for family control, firmware, voice, or special scenes only when they add something useful.
Why Homeowners Are Asking This Now
Nanoleaf now sells both Matter-over-Thread and Matter-over-Wi-Fi lighting, while many homes still have older Essentials bulbs that were bought as HomeKit-over-Thread lights. That creates three very similar-looking products with different setup rules.
The demand signal is current. On July 7, 2026, a Home Assistant Community user posted a solved thread about moving a Nanoleaf Essentials NL45 HomeKit-over-Thread bulb into Home Assistant. The broader Matter/Thread category was also active that week with Thread border router and commissioning issues. Reddit r/homeassistant has separate posts about Nanoleaf Matter Essentials pairing, Nanoleaf Matter-over-Thread downlights, and older A19 Thread bulbs that only make sense once you separate Matter from HomeKit.
The question is not "does Nanoleaf work?" The homeowner question is "which app should I pair first, which integration should I use, and what still depends on Nanoleaf, Apple, Google, or Thread?"
Nanoleaf Paths Compared
This table separates official support, local control, cloud dependency, Matter/HomeKit paths, and the community caveats that matter before you buy or reset lights.
| Nanoleaf setup | Official support | Local control and cloud dependency | Matter or HomeKit path | Choose or avoid |
|---|---|---|---|---|
| Nanoleaf Essentials Matter-over-Thread lights Examples: Matter Thread BR30/E26 bulb, Matter lightstrip, newer Essentials Matter bulbs, and Matter Thread downlights where sold. |
Nanoleaf product pages describe Matter-over-Thread lights as needing a Matter-compatible hub, Thread border router, current firmware, and a compatible phone OS. Home Assistant's Matter docs support local Matter over Thread. | Daily Matter control is local in Home Assistant. The Nanoleaf app may still be useful for firmware, scenes, Circadian Lighting, screen mirroring, or product-specific settings. | Use Home Assistant Matter. Commission with the Home Assistant Companion app after the Thread border router and phone Thread credentials are ready. | Choose when you already have a healthy Thread plan. Avoid if your home has no Thread border router and you do not want to manage Thread. |
| Nanoleaf Matter-over-Wi-Fi lights Example: Nanoleaf Matter Wi-Fi A19 Smart Bulb. |
Nanoleaf sells Matter-over-Wi-Fi bulbs, and Home Assistant Matter supports devices on local Wi-Fi as well as Thread. | Daily Matter control can be local. Wi-Fi quality now matters more than Thread mesh quality. Firmware and some Nanoleaf effects may still use the Nanoleaf app. | Use Home Assistant Matter over Wi-Fi. You do not need a Thread border router for a Wi-Fi Matter bulb. | Choose when you want the simpler no-Thread path. Avoid overloading weak 2.4 GHz Wi-Fi with too many bulbs. |
| Older Nanoleaf Essentials HomeKit-over-Thread or HomeKit-only lights Example: older Essentials A19/NL45-style bulbs that show HomeKit/Thread behavior instead of Matter. |
Home Assistant's Nanoleaf integration does not support Essentials lights, but the HomeKit Device documentation covers HomeKit accessories over Bluetooth and Thread. | Home Assistant can control supported HomeKit lights locally through HomeKit Device after pairing. Apple Home may be needed to get some lights onto an Apple Thread network first. | Use HomeKit Device, not Matter, unless the device has a real Matter upgrade path. Do not confuse this with HomeKit Bridge. | Keep if you already own them and they are stable. Avoid buying old stock if you want a clean Matter setup. |
| Already paired to Apple Home, Google Home, Alexa, or SmartThings Common when a household started with voice assistants before Home Assistant. |
Matter supports multi-admin sharing, and Home Assistant can add already-commissioned Matter devices. HomeKit-only devices are different. | Matter control can remain local, but the original ecosystem may still handle voice, remote access, and app-specific features. | If it is Matter, generate a new sharing code from the existing controller and add it to Home Assistant. If it is HomeKit-only, use HomeKit Device rules. | Choose sharing when the current Thread network is stable. Avoid factory-resetting first unless you know what setup code and network credentials you will lose. |
| Nanoleaf Shapes, Lines, Elements, Blocks, Skylight, or panels These are not the same as Essentials bulbs. |
Home Assistant's Nanoleaf integration supports Light Panels, Canvas, Shapes, Elements, and Lines. Nanoleaf also lists some controllers as Thread border routers on supported firmware. | Panel control can be local through the Nanoleaf integration once configured. Thread border router behavior depends on firmware and the rest of the Thread network. | Use the Nanoleaf integration for supported panels. Treat their Thread border router role as separate from controlling the panel itself. | Choose for decorative panel lighting. Avoid making a Nanoleaf panel your only Home Assistant Thread plan until you have tested it with your other border routers. |
Step 1: Identify the Exact Nanoleaf Light
Do this before you pair, reset, or buy more bulbs. Look for the words on the box and in the product page:
- Matter over Thread: you need Home Assistant Matter plus a Thread border router.
- Matter over Wi-Fi: you need Home Assistant Matter and a stable 2.4 GHz Wi-Fi network, but not Thread for that light.
- HomeKit over Thread: you are probably looking at the HomeKit Device path, not the Matter path.
- Nanoleaf app over Bluetooth: useful for first contact, updates, and features, but not the same as full local Home Assistant control.
- Shapes, Lines, Elements, Canvas, or panels: use the Nanoleaf integration for panel control; do not treat these as Essentials bulbs.
Current examples worth checking by exact product page include Nanoleaf Matter Thread BR30/E26 Smart Bulbs, Nanoleaf Essentials Matter lightstrips, Nanoleaf Matter Wi-Fi A19 Smart Bulbs, and older Nanoleaf Essentials HomeKit-over-Thread A19/NL45-style bulbs. The names are close enough that the protocol label matters more than the marketing family name.
Path 1: Add a Nanoleaf Matter-over-Thread Light Directly to Home Assistant
Use this path when the light clearly supports Matter-over-Thread and Home Assistant should run the automations.
- Confirm the Matter logo and Thread transport. Do not use this path for HomeKit-only Essentials lights.
- Prepare the Thread network. Home Assistant's Thread docs say your Thread network should be known and preferred before adding Matter-over-Thread devices.
- Sync Thread credentials to the phone. Android users use the Home Assistant Companion app's Sync Thread credentials flow. iPhone users use the Thread integration's Send credentials to phone action.
- Update firmware if practical. Nanoleaf recommends pairing in the Nanoleaf app first for extra features, and Reddit users repeatedly report firmware updates changing pairing behavior. If you use the app first, know how to reset or share afterward.
- Add the light through Home Assistant Matter. Use the Home Assistant Companion app near the light and scan the Matter code.
- Test simple control before scenes. Verify on, off, brightness, color temperature, and color before you build automations.
If pairing fails at the network step, do not assume the bulb is bad. In many Matter-over-Thread failures, the missing piece is phone Thread credentials, an unhealthy border router, IPv6 reachability, or a stale setup state.
Path 2: Add a Nanoleaf Matter-over-Wi-Fi Light
Use this path when the product page or box says Matter over Wi-Fi. The Nanoleaf Matter Wi-Fi A19 bulb is the clean example.
- Put the phone on the same local network as Home Assistant. Avoid guest Wi-Fi and isolated IoT VLANs during commissioning.
- Make sure the bulb is on a stable 2.4 GHz Wi-Fi network. A weak access point will feel like a Matter problem even when the Matter stack is fine.
- Add through Home Assistant Matter. Scan the Matter code from the Home Assistant Companion app.
- Keep Nanoleaf firmware current. Use the Nanoleaf app if the bulb needs updates or vendor-specific lighting effects.
This is the calmer choice for many homeowners. It avoids Thread credentials and border router selection, but it puts more devices on Wi-Fi. If you plan dozens of bulbs, consider whether smart switches, Zigbee lighting, or a smaller number of Wi-Fi Matter lights would be more reliable.
Path 3: Add Older Essentials Through HomeKit Device
Use this path for older Nanoleaf Essentials bulbs or lightstrips that are HomeKit-over-Thread rather than Matter. This is the path behind many old forum and Reddit instructions that say to add the bulb to Apple Home first, remove it without resetting, then pair it with Home Assistant.
Home Assistant's HomeKit Device docs explain the reason: HomeKit accessories can only be paired to one controller at a time. Removing the accessory from Apple Home can leave it on the Thread network while opening it for Home Assistant pairing. For HomeKit-over-Thread devices, Home Assistant can also provision preferred Thread credentials once the device is paired.
- Save the HomeKit code. If you lose it, recovery can be manufacturer-specific.
- Make sure Home Assistant can see the accessory. Bluetooth may require a proxy if the hub is far from the bulb.
- Pair with HomeKit Device. This is the Home Assistant integration formerly known to many users as HomeKit Controller.
- Provision Thread if needed. In the device page, use the Thread controls when Home Assistant offers them.
- Export back to Apple only if needed. If the family still wants Siri or Apple Home controls, use HomeKit Bridge from Home Assistant after Home Assistant owns the device.
This path is workable, but it is not the cleanest path for new purchases in 2026. If you are buying today and want local Home Assistant lighting, buy a product that plainly says Matter-over-Thread, Matter-over-Wi-Fi, Zigbee, Z-Wave, or another Home Assistant-friendly path you actually plan to run.
What the Nanoleaf App Still Does
Matter gets basic light control into Home Assistant. It does not guarantee every Nanoleaf-specific feature appears in Home Assistant. Nanoleaf's own pages separate Nanoleaf app features from smart-home ecosystem features, including richer scenes, custom palettes, Circadian Lighting, screen mirroring, and some firmware-related behavior.
The practical homeowner answer is to keep the Nanoleaf app available for maintenance, even if Home Assistant runs the daily automations. That does not mean the Nanoleaf cloud should own your lighting logic. It means firmware, effects, and vendor diagnostics may still live in the vendor app.
Should Nanoleaf Panels Be Your Thread Border Router?
Nanoleaf says Shapes, Lines, and Elements controllers can act as Thread border routers on supported firmware, and Nanoleaf lists Apple, Google, Amazon, and SmartThings hub examples too. That is useful information, but it is not the same as saying every mixed Thread network will be simple.
Home Assistant Community users have reported unstable mixed Thread environments involving Nanoleaf border routers alongside Google or Alexa border routers. That does not prove every Nanoleaf panel will break every home. It does mean a homeowner should not buy a decorative panel solely to be the Thread foundation for Home Assistant.
For a new Home Assistant-centered setup, use a deliberate Thread plan: Home Assistant Yellow, Home Assistant Connect ZBT-1 or ZBT-2 configured for Thread, or an existing Apple/Google/Amazon/eero/SmartThings Thread network that you already know is stable. Then add Nanoleaf lights into that plan instead of letting every ecosystem create its own island.
Which App Should Pair First?
For a fresh Home Assistant-first home, pair a Nanoleaf Matter light to Home Assistant first when the Matter and network setup is ready. Share it to Apple Home, Google Home, Alexa, or SmartThings later only if the household needs those controls.
For an Apple or Google home that already has a stable Thread network, do not reset everything just to change the story. If the Nanoleaf device is Matter, generate a fresh Matter sharing code from the existing app and add it to Home Assistant as an already-paired device. If it is HomeKit-only, follow the HomeKit Device path instead.
For a light that needs firmware before it behaves, use the Nanoleaf app intentionally, update it, then decide whether to reset, share, or commission into Home Assistant. The app is a tool, not the automation brain.
Troubleshooting Checklist
- The Nanoleaf integration does not find my bulb. That is expected for Essentials lights. Use Matter for Matter models or HomeKit Device for HomeKit Essentials.
- Home Assistant says I need a Thread border router. Check that your phone has the right Thread credentials. Home Assistant's Thread docs put this before adding Matter-over-Thread devices.
- The light fails after Bluetooth commissioning. Look at Thread reachability, IPv6, mDNS, VLANs, and whether the device is Matter-over-Thread or HomeKit-over-Thread.
- The Nanoleaf app sees the bulb but Home Assistant does not. Update firmware, verify the protocol, and avoid assuming Bluetooth app control means Matter control is ready.
- Everything works until another border router appears. Mixed Thread border routers can still be rough. Reduce variables, avoid duplicate Thread islands, and test one router family at a time.
- Transitions or effects are not as smooth as the Nanoleaf app. Matter may expose only basic light entities and settings. Vendor effects can remain app-specific.
- You are about to factory reset. Save setup codes, understand which controller currently owns the device, and know whether you are resetting a Matter device or a HomeKit-only device.
Tara Recommendation
If you are buying Nanoleaf lights for a Home Assistant home in 2026, choose based on your network:
- Choose Matter-over-Wi-Fi when you want the easiest Home Assistant path and only need a modest number of bulbs.
- Choose Matter-over-Thread when you already have a deliberate Thread border router plan and want low-power mesh lighting.
- Keep older HomeKit-over-Thread Essentials if you own them and can pair them through HomeKit Device, but do not buy old stock for a new local-first setup.
- Use Nanoleaf panels for panel lighting, not as the cornerstone of a Home Assistant Thread network unless your exact setup has been tested.
For automations, keep one source of truth. Let Home Assistant decide when lights turn on, dim, or follow presence. Let family apps and voice assistants be user interfaces. Let the Nanoleaf app handle firmware and special effects when needed.
Related Tara Reading
- Should You Pair Matter Devices to Home Assistant or Apple/Google First?
- How to Share One Matter Device Across Home Assistant, Apple Home, Google Home, Alexa, and SmartThings
- Which Thread Border Router Should You Use with Home Assistant in 2026?
- Home Assistant: Thread Border Router Required Fix
- Home Assistant HomeKit Device vs HomeKit Bridge: Which Should You Use?
- Can You Use Eve Matter-over-Thread Devices With Home Assistant Without Apple Home?
- Can Aqara Matter-over-Thread Devices Work Without an Aqara Hub?
- How to Run Your Smart Home Without the Cloud
FAQ
Do you need Apple Home to use Nanoleaf Matter lights with Home Assistant?
No. Nanoleaf Matter-over-Thread and Matter-over-Wi-Fi lights can be added to Home Assistant through the Matter integration when the Home Assistant Matter setup, phone app, and required network path are ready. Apple Home is only one possible controller.
Why does the Home Assistant Nanoleaf integration not find Nanoleaf Essentials bulbs?
Home Assistant's Nanoleaf integration supports Nanoleaf Light Panels, Canvas, Shapes, Elements, and Lines, but not Nanoleaf Essentials lights. Use Matter for Matter models, or HomeKit Device for older HomeKit-over-Thread Essentials where supported.
Should you buy Nanoleaf Matter-over-Thread or Matter-over-Wi-Fi lights?
Matter-over-Thread is a good fit when you already have a healthy Thread border router plan. Matter-over-Wi-Fi is simpler if you want to avoid Thread entirely. Either way, check the exact product page and box for Matter plus the transport: Thread or Wi-Fi.
Can Nanoleaf Shapes, Lines, or Elements be the Thread border router for Home Assistant?
Nanoleaf lists Shapes, Lines, and Elements controllers as Thread border routers on supported firmware, but Home Assistant users report mixed multi-router behavior when Nanoleaf border routers share a Thread environment with other brands. Treat them as possible existing routers, not the default Home Assistant Thread plan.
What if a Nanoleaf light is already paired to Apple Home or Google Home?
If it is a Matter device, generate a new Matter sharing code from the existing controller and add it to Home Assistant as an already-paired Matter device. If it is an older HomeKit-only Essentials bulb, use the HomeKit Device path instead of Matter.