Set up your Matter shades
Yamazing motorized shades with a Matter over Thread motor work with the smart home you already have. This guide shows how to add a shade to Apple Home, Google Home, Amazon Alexa or Home Assistant, and how to use the same shade in more than one of them.
Not sure which motor you have? Look for a label with a QR code and an 11-digit number on the motor or in the box. If there is none, your shade uses a different system: contact us and we’ll point you to the right guide.
On this page: before you start · 1. pairing mode · 2. add it to your system · 3. use several systems · troubleshooting
Before you start
- A border router. This is the always-on device that links your shades’ Thread network to your Wi-Fi. Most homes already have one in a smart speaker or streaming box - see the table below.
- Your phone, ready. Turn Bluetooth on, connect to your home Wi-Fi, update the app you’re using, and stand next to the shade while you pair it.
- The shade’s code. Every motor has a label with a QR code and an 11-digit number. One is on the motor itself and two spare stickers come in the box. Stick a spare somewhere you can reach and take a photo of it: once the shade is up, the motor’s own label is hard to get to.
- Power. Charge battery shades fully before you start.
- Limits. Your shades arrive with their open and closed positions already set. If one needs adjusting, see the Remote Quick Start Guide first.
Which border router do I need?
Apple Home
HomePod mini, HomePod (2nd generation), Apple TV 4K (2nd generation), or Apple TV 4K (3rd generation) Wi-Fi + Ethernet, set up as your home hub. The Wi-Fi-only Apple TV 4K (3rd generation) has no Thread radio.
Google Home
Nest Hub (2nd generation), Nest Hub Max, Nest Wifi Pro, Google TV Streamer, or Google Home Speaker. Nest Mini, Nest Audio and the first Nest Hub are not border routers.
Amazon Alexa
Echo (4th generation), Echo Hub, Echo Studio or Echo Dot Max (2025), Echo Show 8 (2025), Echo Show 10 (3rd generation), Echo Show 11, 15 or 21, or a recent eero router. Echo Dot, Echo Pop, Echo Spot and Echo Show 5 are not.
Home Assistant
Any of the devices above, or Home Assistant’s own: Home Assistant Yellow, or a Home Assistant Connect ZBT-2 running OpenThread Border Router.
SmartThings
SmartThings Station or SmartThings Hub v3.
Want to know what a border router actually does? Read how Matter over Thread works.
Put the shade in pairing mode
Do this only for the first system you add a shade to. Every system after that uses a sharing code, and the shade stays where it is.
Find the motor head at one end of the roller. The pairing button is the small round button on it, below the status light.
Press the pairing button 3 times, quickly.
The status light flashes green 3 times, then goes out. The shade is ready: start the setup in your app straight away.
The shade will jog twice
While it connects, the shade moves a little up and down twice. That’s the motor confirming it has paired - nothing is wrong.
Add the shade to your system
Pick the app you use. You can add the same shade to more than one of them afterwards: see Step 3.
You’ll need
- An iPhone or iPad with the latest iOS or iPadOS
- A HomePod mini, HomePod (2nd generation) or Apple TV 4K with Thread, set up as your home hub
Put the shade in pairing mode: press the pairing button on the motor 3 times and wait for the green light to flash 3 times and go out.
Already in another system? Skip this and use a sharing code instead.
Open the Home app, tap +, then Add Accessory.
Scan the QR code on the motor or on a spare sticker.
Won’t scan? Tap More options…, then My Accessory Isn’t Shown Here, then Enter Code, and type the 11-digit number.
Tap Add to Home. The shade jogs twice while it connects.
Choose the room, give the shade a name you’ll say to Siri (for example “Bedroom Shade”), tap Continue, then Done.
In the app
Tap the shade’s icon to open or close it fully. Tap its name to open the slider, and drag to any position.
By voice
“Hey Siri, close the bedroom shade.” “Hey Siri, set the bedroom shade to 50 percent.”
You’ll need
- The Google Home app on Android 8.1 or later, or on an iPhone or iPad with iOS 16.5 or later
- A Google border router: Nest Hub (2nd generation), Nest Hub Max, Nest Wifi Pro, Google TV Streamer or Google Home Speaker
Put the shade in pairing mode: press the pairing button on the motor 3 times and wait for the green light to flash 3 times and go out.
Already in another system? Skip this and use a sharing code instead.
Open Google Home, go to Devices, tap + Add, then Device (on some versions, Matter-enabled device).
Scan the QR code on the motor or on a spare sticker.
Won’t scan? Tap Set up without QR code (or Add a different way) and type the 11-digit number.
When asked to connect the device to your Google Account, tap I agree.
On an iPhone, a second window opens: tap Add to “Google Home”, then Continue on the name screen. Google Home uses the iPhone’s built-in Matter setup, so this is expected.
Pick the room the shade is in and tap Next. When you see Device connected, tap Done.
In the app
On the Devices tab, tap the shade to open or close it. Open the shade to slide it to any position.
By voice
“Hey Google, open the living room shade.” “Hey Google, set the living room shade to 30 percent.”
You’ll need
- The Alexa app on your phone
- An Echo with a Thread border router built in, or a recent eero router (see the table above)
Put the shade in pairing mode: press the pairing button on the motor 3 times and wait for the green light to flash 3 times and go out.
Already in another system? Skip this and use a sharing code instead.
Open the Alexa app, tap + at the top right, then Device.
Scroll to the bottom and tap Other. When asked which logo is on your device, choose Matter, and answer Yes to the questions that follow.
Tap Scan QR Code and scan the code on the motor or on a spare sticker.
Won’t scan? Tap Try Numeric Code Instead?, then Enter Code, type the 11-digit number and tap Next.
Wait while Alexa shows Connecting your device to the network. It can take up to a minute, and the shade jogs twice.
When the shade is found, tap Next, give it a name, tap Update Name, then Done.
In the app
Go to Devices, tap the shade and drag the Opening slider.
By voice
“Alexa, close the bedroom shade.” “Alexa, set the bedroom shade to 50 percent.”
Home Assistant can take the shade on its own or share it with Apple Home, Google Home or Alexa. If you already use one of those, Option A is the quickest.
You’ll need
- Home Assistant OS with the Matter integration. Add it in Settings → Devices & services; on Home Assistant OS, selecting Submit installs the Matter Server app for you.
- IPv6 set to Automatic in Settings → System → Network
- A Thread border router: one from Apple, Google or Amazon, or Home Assistant’s own
- The Home Assistant Companion app on your phone, with Bluetooth on. On Android, set its location permission to Allow all the time.
Option A: share it from Apple, Google or Alexa
Add the shade to Apple Home, Google Home or Alexa first, following the steps in that system’s tab.
In the Home Assistant app, go to Settings → Connectivity → Matter and tap Add device.
Choose Yes. It’s already in use., pick the system the shade is in, and follow the instructions. When asked for a code, create a sharing code in that app and enter it.
In the Device added window, name the shade, pick an area, and tap Finish.
Option B: Home Assistant on its own
Make sure your phone knows your Thread network.
- iPhone: in the Home Assistant app, go to Settings → Connectivity → Thread and tap Send credentials to phone under your preferred network.
- Android: go to Settings → Companion app → Troubleshooting and tap Sync Thread credentials.
Put the shade in pairing mode: press the pairing button on the motor 3 times and wait for the green light to flash 3 times and go out.
Already in another system? Skip this and use a sharing code instead.
In the Home Assistant app, go to Settings → Connectivity → Matter, tap Add device, and choose No. It’s new.
Scan the QR code on the motor or on a spare sticker.
Won’t scan? Tap More options… on iPhone or Setup without QR-code on Android, and type the 11-digit number.
On iPhone, tap Add to Home Assistant, then Done when it finishes.
In the Device added window, name the shade, pick an area, and tap Finish.
Border routers from more than one brand?
An Apple, a Google and an Amazon border router can each start a separate Thread network, and a shade on one can’t be reached through another. In Home Assistant, choose one network under Settings → Connectivity → Thread and pair everything to that one.
In the app
The shade appears as a cover with open, close, stop and a position slider. Use it in automations - close the west-facing shades at sunset, for example.
By voice
Through Assist, or through any voice assistant you’ve also shared the shade with.
Keep the connection strong
Your shades sleep between commands to save power, so they never pass signals along for other devices. Always-on devices do that: your border router, smart speakers, and Matter over Thread smart plugs. The more of them around the house, the stronger the network.
We recommend one Matter over Thread smart plug in each room with shades, especially rooms far from your border router. Ask us and we’ll add one to your order.
Your remote always works. It talks to the motor directly by radio, so it keeps working even when your Wi-Fi, internet or border router is down.
The full picture, with diagrams of three real homes: how Matter over Thread works.
Troubleshooting
The app can’t find my shade
Check that Bluetooth is on and that you are standing within a few feet of the shade. Press the pairing button 3 times again - pairing mode does not stay open for long - and restart the setup in the app. Make sure your border router (HomePod, Apple TV, Nest hub, Echo or Home Assistant) is plugged in and up to date. If the shade is already in another system, its printed code will not work: create a sharing code in that system instead.
The app says my code is invalid or already in use
The shade has already been added to a system, and the printed code only works for the first one. Open the system the shade is already in, create a sharing code, and enter that code instead. If you no longer have access to that system, contact us and we will help you reset the shade.
My shade shows “No Response” or “Offline”
If it is a battery shade, charge it first. Then check that your border router is plugged in and online. If only the shades farthest from the border router drop out, the Thread signal is too thin there: add an always-on Thread device, such as a Matter over Thread smart plug, in that room. Your remote keeps working in the meantime.
The shade takes a moment to respond
That is normal. To make a battery last, the motor sleeps between commands and checks for new ones every few moments. Once it has moved it stays awake briefly, so a second command lands faster.
My shade showed up with a generic name
Every shade arrives with the same default name. Rename it in the app to something you would say out loud, such as “Bedroom Shade”, so that Siri, Google and Alexa can tell your shades apart.
My sharing code expired
Sharing codes only last a few minutes. Create a new one and enter it in the other app straight away.
How do I remove a shade from a system?
In Apple Home, open the shade, tap the settings button and choose Remove Accessory. In Google Home, open the shade’s settings and choose Remove device. In Alexa, open the shade’s settings and tap the trash icon. In Home Assistant, open the device, tap the three-dot menu and choose Delete. Removing a shade from one system leaves it working in the others.
The shade stops in the wrong place
The open and closed positions (the limits) are stored in the motor, not in your smart home app. Your shades arrive with them already set; to adjust one, follow the limit steps in the Remote Quick Start Guide, or contact us.
Do my shades need the internet?
No. Matter runs on your home network, so the apps keep working when the internet is down, although voice assistants need it to understand you. The remote does not need the network at all: it talks to the motor directly by radio.
Still stuck?
Tell us which system you’re using and what the app says. We’ll walk you through it.
Steps checked against Apple, Google, Amazon and Home Assistant documentation in September 2026. Apps change with updates: if a button has moved, follow the prompts in the app.