Pairing > Nanoleaf App > iOS

GETTING STARTED

✅ Lay out your lights on the floor or table before mounting. 
✅ Plug in your display before mounting for a quick power test.
✅ Make sure all panels/bars are connected using linkers before pairing.
📽️ More of a visual person? Check out our Visual Pairing Guide

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.

Ready to Pair? Let’s Light Things Up.
How-To: Standardized Pairing on iOS 🍏
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •
STEP 1 ⨠ 
Download or Update the Nanoleaf App

💡The official Nanoleaf App is available as a free download in the App Store. Make sure you have the latest version. 🔗App Download

📲 Your mobile device must also be on 2.4GHz during setup and Bluetooth must be turned ON.

STEP 2 ⨠ 
Pair Your Device

✅ Open the App;
✅ On the Dashboard, tap the pencil ✏️ icon in the top right corner;
✅ Tap Add Device +;
✅ The app will automatically open up the pairing window. Follow the instructions on the screen to either:

Option A: Scan the QR code.

Option B: Manually Enter in the 8-digit pairing code (11-digits pairing code on Matter devices) found on the back of your Controller/Bulb base or Quick Start Guide/Welcome Card.

Option C (Not for Blocks or Expo Display Case): Use NFC Tap, by holding the top of your mobile device over the buttons of your Controller/Bulb base.

In some cases, you may be required to Provide Permission. Once the Nanoleaf App pairs with the device, it will ask for permission to access your network to check for available Wifi networks. Once located, a prompt will request that you enter your password for the preferred Wifi network.

Optional: Naming & Room Assignment: Name your device and assign it to a room.

🎉 PAIRING COMPLETE | Once pairing is complete, most Nanoleaf panels should flash green or illuminate in some way and then, they're ready to go on the Nanoleaf App!

[OPTIONAL] STEP 3 | Connect Using Matter/Connecting to a Smart Home Ecosystem 

Smart Home Ecosystem Setup: If a smart home hub and/or a compatible Thread Border Router are present in the home and detected by the Nanoleaf app, you'll be provided with the option to connect your light to Matter.

 Otherwise, you will be taken back to the Dashboard.

If you’re pairing with a smart home ecosystem like Apple Home, make sure you're on iOS 16.5+. Nanoleaf devices use Wifi, Matter Thread, or Matter Wifi to connect your device(s)/lights using specific connection protocols.

An image, similar to the one on the left, will pop up to prompt you. 

You can also skip this and connect at another time.

Device Requirements: iOS 15.4+ is required to pair with the Nanoleaf app and iOS 16.5+ is required to connect to a Smart Home Ecosystem (e.g., Apple Home). Additional requirements may apply.

Network Requirements: A 2.4GHz network is required (Nanoleaf products don’t work on 5GHz). Turn Bluetooth ON.

Pairing Code: Find your QR code or 8-digit code on your Quick Start Guide or the back of your Controller/Bulb base. Matter devices have an 11-digit pairing code.

• • • • • •

🆘 Need help? Submit a ticket request: Software Support > Pairing or Setup Issues By setting yourself up as a registered user, you will be able to track the status of your ticket.

Keyword search: iOS pairing, How to pair on iPhone, QR code pairing, pairing code setup, iOS HomeKit, not pairing iPhone, Nanoleaf 4D iOS setup.