Xiaomi Smart Button: A Complete Guide to Setup and Application

Xiaomi has long since ceased to be just a smartphone manufacturer, with its ecosystem of smart devices spanning every walk of life, from light bulbs to robot vacuum cleaners. One of the simplest yet most powerful gadgets in the lineup is the smart button, a compact device that can run automation chains at a single click, which at first glance looks like a normal wireless switch, but in fact it is turning into a smart home control center, saving time and simplifying routine.

Many users underestimate the potential of smart buttons as a “toy” for the lazy. However, competent setting allows you to solve tasks that used to take minutes: for example, turning off all the lights in the house with one click, running a “Leave to work” scenario (coffeemaker, air conditioner, alarm) or even sending a notification to relatives that you are home.

Xiaomi’s smart buttons are versatile, and they’re not only compatible with devices in the same ecosystem. Home/Aqara), But with other smart home platforms, such as Home Assistant, Google Home or Apple HomeKit (with limitations), this makes them an indispensable tool for creating cross-platform automation systems where one click can control devices from different brands.

What is Xiaomi Smart Button and How Does It Work?

A smart button is a wireless device with one or more physical buttons that sends a signal to the smart home hub when you press it. Unlike classic switches, it doesn't require wiring and can be placed anywhere, on a wall, a desk, or even in your pocket, and its main advantage is the flexibility of the setting: the same tap can trigger different actions in different scenarios.

Technically, the button works on the Zigbee protocol (Aqara models) or Wi-Fi (rare variants), communicating with the hub (Mi Home Hub, Aqara Hub or Redmi Router). AX6S The signal from the button is processed by the hub, which already manages other devices - lamps, sockets, sensors. The delay between pressing and executing a command usually does not exceed 0.5-1 seconds.

Key features of Xiaomi smart buttons:

• 🔋 Autonomy: battery-operated (usually) CR2032 or CR2450) 2–3 years.
• 🛡️ False positive protection: recognize single, double pressing and retention.
• 🌐 Cross-platform: Mi Home, Home Assistant, Yandex Alice (through third-party integrations).
• 🔄 Multitasking: One button can control multiple devices at once.

Important: Xiaomi buttons don’t work directly with the cloud — they always need a local hub (except for Wi-Fi models, but they’re less stable), which means that when the Internet is turned off or the hub breaks, the button will become useless.

Xiaomi smart button models: comparison and features

Xiaomi and its Aqara sub-brand feature several smart button models with design, functionality and communication protocol, below is a comparison table of current devices (2026):

For most tasks, a single-button model (Mi Smart Button or Aqara Mini Switch) is sufficient. Multi-button variants (Aqara Opple) are convenient for controlling several scenarios from one place, for example, in the hallway: one button is light, the second is air conditioning, the third is alarm.

⚠️

Note: Check the compatibility of the button with your hub when buying. For example, the Aqara Opple does not work with the first-generation Mi Home Hub - you need an Aqara Hub M2 or newer.

How to connect a smart button to the Mi Home system

The process of connecting the button to the Mi Home ecosystem takes no more than 5 minutes, but requires preliminary preparation.

• 📱 Smartphone with Mi Home app installed (version no lower than 6.0).
• 🔌 Xiaomi or Aqara Hub (networked and added to the app).
• 🔋 Battery for the button (usually included).

Step-by-step:

1. Open Mi Home and go to Devices → Add Device.
2. Choose the category of Smart Home → Switches and find your button model.
3. Press and hold the button on the device until the indicator flashes (usually 5 seconds).
4. Wait for the synchronization with the hub to be completed (notification will appear in the application).

If the button is not detected:

• 🔄 Restart the hub (turn off power for 10 seconds).
• 📶 Check that the hub and smartphone are on the same Wi-Fi network.
• 🔋 Replace the battery (even if it’s new, factory marriage is possible).

⚠️

Note: The Aqara buttons may require resetting when you first connect, and press and hold the 10 seconds button until the indicator flashes red.

Automation Scenarios: What Can Be Done With a Smart Button

The main advantage of a smart button is that it can run complex scenarios at the touch of a single click.

1.The smart home is out.

• 🔌 Single press: turns off all lights, sockets, air conditioning.
• 🔒 Double press: activates alarm and blocks smart lock.
• 📱 Retention: Sends a notification to Telegram that you have left.

2. Night mode

• 🌙 Single press: dimms light up to 30%, turns on the nightlight, closes the curtains.
• 🎵 Double tap: triggers white noise on the Mi Smart Speaker.

3. Emergency situations

• ⚠️ Holding 3 seconds: turns all lamps to full brightness and sends SOS numbered.

To create scripts in Mi Home:

1. Go to Profile → Automation → Create a script.
2. Select the Smart button trigger and specify the type of press.
3. Add actions (e.g., Turn on the lamp, Send a notification).
4. Save the script and test it out.

💡

Use different types of presses (single, double, hold) for a single button – this will allow you to manage three scripts from one device.

Compatible with other platforms (Home Assistant, Google Home, Alice)

While Xiaomi’s smart buttons are optimized for the Mi Home, they can be integrated into other smart home systems.

1. Home Assistant

To connect the button to the Home Assistant, you will need:

• 🔌 Xiaomi or Aqara Hub Connected to Home Assistant Through Integration Zigbee2MQTT Mi Home Integration or Mi Home Integration.
• 📝 Configure configuration.yaml with button identifier.

Example of code for configuration.yaml:

binary_sensor:


- platform: mqtt




name: "Xiaomi Button"




state_topic: "zigbee2mqtt/0x12345678" # Replace your button with ID




value_template: "{{ value_json.action }}"




payload_on: "single"




payload_off: "double"

2. Google Home / Apple HomeKit

There is no direct support, but you can use workarounds:

• 🔄 Home Assistant with Google Assistant or HomeKit integration.
• 🌐 Through cloud services, like, IFTTT (delayed up to 5 seconds).

3.Yandex Alice

Xiaomi buttons are not officially supported by Alice, but you can set up interactions through:

• 🔌 Yandex Smart Home + Mi Home (requires manually binding devices).
• 📲 Third-party scripts in Python using API Mi Home.

⚠️

Note: When using third-party integrations (e.g, Zigbee2MQTT) The button may lose communication with the hub after updating the firmware.

Typical problems and their solutions

Even simple devices like smart buttons crash, and let's look at the most common problems and ways to fix them:

1.The button does not respond to pressing

• 🔋 Check the battery (voltage should not be lower) 2.8V).
• 📡 Make sure the button is within the hub’s range (maximum 10-15 meters without obstacles).
• 🔄 Reconnect the button to the hub (remove and add again).

Delay in operation (more than 2 seconds)

• 🌐 Check the load of the Zigbee network (too many devices can interfere with the network).
• 🔄 Reboot the hub.
• 📶 Reduce the distance between the button and the hub or add a signal repeater (e.g. Aqara Range Extender).

3. The button is triggered arbitrarily.

• 🛠️ Check the mounting - vibrations can cause false pressing.
• 🔋 Replace the battery (a discharged battery may cause failures).
• 🔄 Update the hub and button firmware (if available).

💡

If the button is unstable, try resetting it to factory settings (hold the 10 seconds button) and plug it back in again, which solves the problem 80 percent of the time.

Alternatives to Xiaomi Smart Buttons: What to Choose

If you don’t like the Xiaomi buttons, consider alternatives from other brands.

For the Xiaomi ecosystem, the best choice is the Aqara Wireless Mini Switch (if you need Zigbee) or the Mi Smart Button (if you already have a hub). Button1 Or Philip Hue, but they're more expensive).

💡

If you need a button to manage Apple’s HomeKit, consider Philips Hue or Aqara with Home Assistant integration – they’re more stable than Xiaomi’s workarounds.

FAQ: Frequent questions about Xiaomi smart buttons