Xiaomi Smart Button: How to Connect to Mi Home and Other Systems in 5 Minutes

Xiaomi’s smart buttons are compact devices that turn ordinary actions into automated scenarios, which can turn on lights, run a robot vacuum cleaner, control outlets, or even send notifications to a smartphone at a single click. But before enjoying the convenience, you need to connect the gadget correctly to the ecosystem. This article will help you understand all the nuances from model selection to integration with Apple HomeKit and Google Assistant.

We'll look at not only the standard Mi Home pairing procedure, but also alternative ways for users who have errors like "Device not found" or "Can't add" and how to make the button work with other smart home platforms without buying additional hubs.

Important: the instruction is relevant for all popular models - from the budget Xiaomi MiJia Wireless Switch to the advanced Aqara Opple 6-Button Switch. If your button isn't defined by the system, there's a section at the end of this article that addresses the most common problems.

What Xiaomi Smart Buttons Are and How They Differ

Xiaomi and its sub-brand Aqara are launching several types of smart buttons that differ in functionality, design and compatibility, and here are the main models that will be available in 2026:

• 🔘 Xiaomi MiJia Wireless Switch is a classic ZigBee-enabled single-button model that only works through the Xiaomi Gateway hub.
• 🔘 Aqara Opple Single Rocker – stylish button with mechanical switch, compatible with HomeKit (requires Aqara Hub).
• 🔘 Redmi Smart Wireless Switch – budget version with Bluetooth, does not require a hub, but has limited functionality.
• 🔘 Aqara Opple 6-Button Switch – Multi-button panel for complex scenarios (e.g., managing multiple devices with one button).

The main difference between the models is the communication protocol:

• 📡 ZigBee is reliable, energy efficient, but requires a hub (e.g. Xiaomi Gateway 3 or Aqara Hub) M2).
• 📶 Bluetooth – works directly with your smartphone, but has a limited range (~10 meters) and discharges faster.

If you plan to use the button to control other devices (such as lamps or sockets), choose models with ZigBee. For simple tasks like sending notifications, a Bluetooth option will also work.

What you need to connect the Xiaomi smart button

Before you start setting up, make sure you have everything you need. Here's the full checklist:

Download the Mi Home app (or Aqara Home for related models)

Charge the button (if it is a model with a battery)

Connect the hub to the network (for ZigBee buttons)

Make sure your smartphone is connected to 2.4GHz Wi-Fi

Shut down. VPN Firewalls (they can block the connection)-->

Pay special attention to Wi-Fi frequency. Xiaomi smart devices only work with 2.4 GHz networks. If your router broadcasts both frequencies (2.4 and 5 GHz) under the same name, divide them in the router settings. Otherwise, the Mi Home application will not be able to find the button.

Also check the region in the app. By default, the Mi Home can be set to China, which will cause problems with adding devices.

1. Open Mi Home and go to Profile → Settings → Region.
2. Choose Russia (or Europe if there is no Russia).
3. Restart the app.

⚠️ Note: If you are using Aqara Opple and are planning to integrate with Apple HomeKit, add a button to the Aqara Home app first, not to the Mi Home.

Step-by-step: how to connect the Xiaomi smart button to the Mi Home

Consider the standard add-on process with the Xiaomi MiJia Wireless Switch (ZigBee), and the steps may vary slightly for other models.

Step 1: Hub preparation

If your button is running on ZigBee, first make sure that the hub (such as Xiaomi Gateway 3) is connected and working:

1. Put the hub in the socket.
2. Wait until the indicator starts flashing blue (pairing mode).
3. Add a hub to Mi Home via Add Device → Gateway.

Step 2: Activate the button pairing mode

To make the button visible to the hub, it must be switched to add mode:

• 🔧 For MiJia Wireless Switch: Press the button for 5 seconds until the indicator flashes quickly.
• 🔧 For Aqara Opple: Press and hold both buttons (if it’s a two-button model) for 10 seconds.

Step 3: Add to Mi Home

Now add a button to the app:

1. Open Mi Home and press + → Add the device.
2. Choose the category of Smart Home → Buttons.
3. Click on your button model (e.g., Xiaomi Wireless Switch).
4. Wait for the app to find the device (it can take up to 30 seconds).
5. Assign a room and name to the button (e.g., “Bedside button”).

If the button is not located, try:

• 🔄 Reboot the hub (remove from the socket for 10 seconds).
• 📱 Reinstall the Mi Home app.
• 🌍 Changing the region to China (sometimes helps with mistakes).

💡

If the button is defined but not added, try to bring it as close to the hub as possible (at a distance). 1-2 Sometimes interference from other devices interferes with pairing.

How to set up actions for a smart button

By itself, plugging a button is useless unless you configure the automation scenarios. In Mi Home, it's done through Automation.

Creating a simple scenario

Let’s say you want the Yeelight lamp to be turned on at the click of a button:

1. At Mi Home, go to Automation. → Create → Smart button.
2. Select your button and action (such as Single Press).
3. Add the device to control (lamp, socket, etc.).
4. Select the action (on/off).
5. Save the script.

Advanced settings

Aqara Opple buttons support up to 6 different actions:

To configure multi-button scenarios:

1. In Mi Home, select your button.
2. Go to the Device Settings → Button management.
3. Set an action for each type of press.

⚠️ Note: If you use Redmi Smart Wireless Switch (Bluetooth), scripts will only work when you are actively connected to your smartphone. Once the phone is out of range, the button will become useless.

How to connect Xiaomi’s smart button to Apple HomeKit

If you’re using the Apple ecosystem, you can integrate a button into HomeKit, but only if you meet two conditions:

1. You must have an Aqara Opple button (other Xiaomi models are not supported).
2. You should use the Aqara Hub (not Xiaomi Gateway!) hub.

Instructions for connection:

1. Add a button to the Aqara Home app (not in Mi Home!).
2. Go to Profile. → HomeKit.
3. Click Add to HomeKit and scan. QR-code.
4. In the app Home on the iPhone will appear a new device.

Now you can:

• 🏠 Assign an action button through the Home app.
• 🔄 Use it in automation scenarios (e.g., “When holding the button, close all curtains»).
• 📱 Manage it via Siri (e.g., “Hey Siri, activate the button at the door»).

How to connect the Xiaomi button to Google Assistant or Alice

Integration with Google Assistant or Yandex Alice will require an intermediate solution, as direct support is not available.

Method 1: Through IFTTT

IFTTT (If This Then That – a service for creating chains of automation between different platforms.

1. Register at iftt.com.
2. Connect Mi Home and Google Assistant.
3. Create an applet using the template: If (If): Google Assistant → Say a simple phrase (for example, "Activate the button"). → Press a button (select your button and action).

Method 2: Through Home Assistant

Home Assistant is an open platform for smart homes that supports Xiaomi and voice assistants.

1. Install Home Assistant on a Raspberry Pi or other computer.
2. Add Xiaomi Mi Home integration (you will need a token from your account).
3. Connect with Google Assistant via Google Home or Alice via Yandex Smart Home.

Both require initial adjustment, but you have flexibility to control, for example, you can set Alice to turn on the lights on the command "OK Yandex, press the button," even if you're not at home.

Common mistakes and their solutions

When connecting Xiaomi smart buttons, users often face typical problems, and here are the most common ones and ways to fix them:

If the Aqara button is not added to HomeKit, check:

• 🔌 Is the Aqara Hub connected to the 2.4 GHz network (not 5 GHz!).
• 📱 Is Aqara Home Updated to the Latest Version.
• 🔄 Does the antivirus block or VPN Connection to Aqara servers.

⚠️ Note: Xiaomi buttons with the ZigBee protocol do not work directly with Google Home or Alexa – only through intermediary services like Google Home and Alexa. IFTTT If you need native support, choose devices labeled Works with Google Assistant or Alexa Built-in.

FAQ: Frequent questions about Xiaomi smart buttons

💡

If your Xiaomi smart button doesn’t connect, 90% of the time the problem is incorrect hub settings, Mi Home region settings, or Wi-Fi network conflict.