How to add a Xiaomi device to Mi Home: instructions for all types of gadgets

Xiaomi’s smart device ecosystem includes hundreds of gadgets, from light bulbs and outlets to robot vacuum cleaners and security systems, but before they work for you, they need to be properly connected to the Mi Home app (or Mi Home Lite for the European region), the process of adding seems simple, but in practice users face synchronization errors, Wi-Fi problems or firmware incompatibility.

In this article, we will discuss all the ways to add Xiaomi devices – from classic scanning QR-pre-manual MAC-You'll learn how to connect your gadget via Bluetooth if you don't have Wi-Fi, why some devices aren't identified in the app, and what to do if the process is stuck in the "connection" phase. We will also focus on the features of connecting devices with the Zigbee protocol (for example, Aqara sensors), which require a hub like the Mi Smart Hub.

The instructions are valid for all regions (China, Europe, Russia) and the 2023-2026 versions of the Mi Home app, and if your device is not added despite following the manual, there is a section at the end of the article with typical errors and their solutions.

1. Preparation before addition of the device

Before you start connecting, make sure that the basic conditions are met, and ignoring them is the cause of 70% of failed attempts to add gadgets.

Requirements for Wi-Fi network:

• 📶 2.4 GHz – Most Xiaomi devices (except flagship models) do not support 5 GHz. If your router only broadcasts 5 GHz, turn on compatibility mode or use a separate access point.
• 🔒 Lack of filtration MAC-Addresses – some routers block new devices by default. Disable this feature in the router settings (wireless section) → MAC Filter).
• 🌐 Internet access – even if the device is running locally (like a light bulb), a connection to Xiaomi servers is required for initial setup.

Device requirements:

• 🔋 Battery charge – if the gadget is powered by a battery (sensors, cameras), make sure that the charge is not lower than 50.
• 📱 Distance to router - keep the device no more than 2 meters away from the router during setup.Walls and interference can interfere with synchronization.
• 🔄 Reset to factory settings – if the gadget has already been in use, reset (usually by holding the power button 5-10 seconds).For Aqara sensors, use the needle to press the hidden Reset button.

Make sure Wi-Fi is running at 2.4GHz |

Disable VPN and proxy on your phone |

Charge the device (if the battery is recharged)|

Reset the gadget to factory settings|

Place the device next to the router-->

Requirements for the Mi Home application:

• 📲 Update: Update the app to Google Play or App Store. Older versions may not support new devices.
• 📍 The correct region - in the profile settings (Profile) → Settings → Region: Select Russia (or Europe for Mi Home Lite) Region mismatch is a common cause of error "Device not supported".
• 🔑 Authorization – Sign in to your Mi Account. Without it, devices will not be linked to your profile.

💡

If you have a dual-band router, create a separate network for smart devices only on the Internet. 2.4 GHz. Name it, for example, Xiaomi_2.4G, Not to be confused with the main network.

2. Standard method: addition through QR-code

This is the most common method, which works for 90% of Xiaomi devices, from Yeelight light bulbs to Mi Robot robot vacuum cleaners. The instructions are universal, but there may be nuances for specific models (we will discuss them below).

Step-by-step:

1. Open the Mi Home app and go to the Devices tab (Icon "+" top-right).
2. Select Add the device → Add manually (if the automatic search fails).
3. In the category list, find the type of your gadget (e.g. Lighting, Security, Climate).
4. Choose a particular model. If it's not on the list, try the Other or Unknown device option.
5. It'll appear on screen. QR-Bring the device’s camera to this code (or scan the code on the gadget’s body if it’s there).
6. Wait until the device emits an audible signal or flashes an indicator (usually blue or orange).
7. Enter the Wi-Fi password and confirm the addition.

What to do if QR-code not scanned:

• 🔦 Lighting - make sure the code is well lit. Bright sunlight or shadow may interfere with scanning.
• 📵 Camera resolution – if you use your phone, check that the app is allowed to access the camera (Phone Settings) → Annexes → Mi Home → Permits).
• 🔄 Alternative method - instead of QR-try to enter the code MAC-device address (specified on a sticker or box) manually.

Features for different types of devices:

Smart light bulb|

Socket or switch|

Sensor (movements, leaks, doors)|

Robot vacuum cleaner|

Camera or video intercom|

Other gadgets-->

3. Addition of devices without QR-code (manual input)

Some Xiaomi devices (especially older models) OEM-versions) do not have QR-In this case, manual identifier input is used — MAC-address S/N (This method is also useful if the camera phone is not working.

Instructions for manual addition:

1. In the Mi Home app, select Add Device → Add it manually.
2. Scroll down the category list and select Other or Unknown Device.
3. Press Add Add on MAC-Address (or Add to) S/N).
4. Enter the ID from a sticker on the device or box: MAC-address: XX:XX:XX:XX:XX:XX (12 colon-separated). S/N: usually 14–16 spaceless.

Confirm the input and follow the further instructions (enter Wi-Fi password, synchronization).

Where to look for identifiers:

• 📦 A box is usually a sticker with MAC and S/N bottom-side.
• 🔧 The body of the device - under the lid of the battery compartment (for sensors) or on the back panel (for sockets, light bulbs).
• 📄 Documentation - in the warranty card or instructions.

💡

If the device was previously linked to another account, it must first be removed from someone else’s profile through Settings. → Public access → Remove the device.

Problems with manual addition:

⚠️ Warning: If the app gives an error "Device is already tethered" but you are sure it is new, it may mean that the gadget was tested in the factory and not reset. Try resetting it to factory settings (hold the button 10-15 seconds until the indicator blinks).

For Zigbee devices (such as Aqara sensors), manual input does not work – they require a pre-connection to the hub (Mi Smart Hub or Aqara Gateway), and once linked to the hub, they will automatically appear in the Mi Home app.

Connection via Bluetooth (for devices without Wi-Fi)

Some Xiaomi gadgets (for example, fitness bracelets Mi Band or wireless headphones Mi AirDots) connect exclusively via Bluetooth and do not require Wi-Fi. They use a separate application - Mi Fit or Xiaomi Wear.

Instructions for Mi Band and similar devices:

1. Download the Mi Fit app (for Mi Band) or Xiaomi Wear (for Watch) S3 etc.).
2. Sign up or sign in to your Mi Account (must match your Mi Home account if you want to sync your data).
3. Turn on Bluetooth on your phone and place the device next to you (no further than 1 meter).
4. In the app, click Add Device and select the model from the list.
5. Follow the instructions on the screen (usually you need to confirm the connection on the gadget itself – for example, click on the Mi Band sensor).

Features of Bluetooth connection:

• 📱 Compatibility – some older Mi Band models (such as Mi Band 2) are not supported by the latest Mi Fit versions. APK from apkmirror.com.
• 🔋 Battery charge – if the device is discharged below 20%, it may not appear in the list available for connection.
• 🔄 Reset – if the gadget was already paired with another phone, reset it through the menu on the device itself (for Mi Band – hold the sensor for 10 seconds).

Sync with Mi Home:

Some devices (such as the Mi Smart Scale 2) can transfer data to both Mi Fit and Mi Home, so that it can be displayed in both applications:

1. Connect the gadget through Mi Fit.
2. At Mi Home, go to Profile → Settings → Synchronization of data.
3. Enable the option to Sync with Mi Fit.

💡

If your Mi Band isn't connecting, try turning off battery saving for the Mi Fit app in your phone's settings. On Android: Settings → Annexes → Mi Fit → Battery → No restrictions.

5. Connecting Zigbee devices (Aqara, Mi Smart Hub)

Zigbee-based devices (Aqara sensors, Mi Smart Switch switches) don't connect directly to Wi-Fi. They need a hub, a central device that acts as a bridge between the Zigbee network and your router. In the Xiaomi ecosystem, this is the role of:

• Mi Smart Hub (also known as Mi Gateway)
• Aqara Hub (for Aqara devices)
• Mi Smart Speaker (some models have a built-in Zigbee hub).

Step-by-step connection via hub:

1. Connect the hub to the outlet and wait until it lights up orange (setup mode) or blue (ready to go).
2. In the Mi Home app, add the hub as a normal device (via the app). QR-code).
3. After successfully connecting the hub, click on it in the list of devices and select Add Device.
4. Activate pairing mode on the Zigbee device: For Aqara sensors, press the button on the case 1 time (the indicator must flash blue). For Mi Smart Switch switches, hold the button for 5 seconds.

Wait 10 to 30 seconds until the hub detects the device. Confirm the addition in the app.

Typical problems with Zigbee devices:

• 🔌 Hub does not turn on - check the power supply (should be on) 5V/1A). Some hubs are sensitive to voltage surges.
• 📡 The device is not detectable – the maximum distance between the hub and the sensor is 10 meters (no obstacles). For large houses, use signal repeaters (for example, Aqara Range Extender).
• 🔄 Network conflict: if you have multiple hubs, they must run on the same Zigbee network, otherwise the devices will jump between hubs.

The difference between the Mi Smart Hub and the Aqara Hub is:

6. Solving typical errors when adding devices

Even if you follow the instructions, the device may not connect, and here is a list of the most common errors and ways to fix them.

Error: "I was unable to connect to the device"

• 📶 Wi-Fi problem - check that the network is running at 2.4GHz. VPN or a proxy on the phone.
• 🔄 Reset the device – perform reset (hold the 10 seconds button) and try again.
• 📱 Update the app – Older versions of Mi Home may not support new devices.

Error: "The device is not supported in your area"

• 🌍 Change region – in Mi Home go to Profile → Settings → Region and select Russia (or Europe for Mi Home Lite).
• 🔧 Firmware of the device - some Chinese models require firmware for the European region. Use the Mi Home Hack utility (at your own risk and risk!).

Error: “The device is already linked to another account”

• 🔑 Resetting – if the device is used, ask the previous owner to delete it from your account via Settings → Public access.
• 📧 Contacting the former owner is impossible, write to Xiaomi support with proof of purchase (check, photo box).

💡

If you buy a device on AliExpress or from an unofficial store, you're at risk of it being linked to a Chinese account.

Mistake: “Failure to obtain IP-address"

⚠️ Note: This error is often caused by the router settings. DHCP-router (LAN → DHCP Server) automatic assignment enabled IP And there's enough free addresses in the pool. IP, add MAC-device address on the exclusion list.

Error: "Device is not responding" after connection

• 📡 Weak Wi-Fi signal – Move the router closer to the device or use a repeater.
• 🔌 Unstable power supply - for sockets and light bulbs, check the contacts in the cartridge / socket.
• 🔄 Reboot – Turn the device off power for 30 seconds, then turn it on again.

7. Setup of the device after connection

Successfully adding a device to the Mi Home is only half the battle, and to make it work properly, you have to configure it: name it, add it to the room, create automation.

Basic settings:

1. Go to the device card in Mi Home (stamp it in the main menu).
2. Press three points (⋮) in the upper right corner and select Settings.
3. Assign a meaningful name to the device (e.g., “Bedroom Lamp” instead of “Bedroom Lamp "Yeelight_123"). It'll make voice control easier.
4. Select the room where the device is located (e.g., "Kitchen", "Living Room"). This is for automation scenarios.
5. Set the default settings: Light bulbs, brightness, color temperature; sensors, sensitivity, delay; sockets, on/off timer.

Creating automation:

One of the key benefits of a smart home is automatic scripting.

• 💡 "Smart alarm clock – the lamp gradually turns on 30 minutes before the alarm clock.
• 🚪 "Security" - when the door is opened (Aqara sensor) the camera is turned on and a notification is sent.
• 🌡️ "Climate control – the air conditioner is turned on if the temperature is above 25°C (Mi Temperature Sensor data).

How to create a script:

1. In Mi Home, go to the Automation tab (icon) ⚙️ bottom-screen).
2. Click Add Automation Add → Manually crafted.
3. Select a trigger (optional condition, such as "Temperature" > 25°C").
4. Select an action (which should happen, such as "Switch on air conditioning").
5. Save the script and activate it.

Voice control:

Xiaomi devices support voice assistants:

• 🗣️ Alice (Yandex) – connect the Mi Home account in the Alice settings (Smart Home) → Xiaomi).
• 🤖 Google Assistant – Go to Mi Home Profile → Settings → Voice assistant → Google.
• 🍎 Siri (HomeKit) – only works with Aqara devices connected via Aqara Hub.

💡

For voice control, use simple device names without spaces or special symbols, such as "lamp chamber" instead of "lamp in the bedroom."

8. Frequently Asked Questions (FAQ)