
Aqara Pairing Mode by Device Type: Sensors and Switches
Aqara pairing mode isn't one procedure. Sensor, switch, and H2 Thread-mode gestures for Zigbee2MQTT and ZHA, plus why a device never appears.

Aqara pairing mode isn't one procedure. Sensor, switch, and H2 Thread-mode gestures for Zigbee2MQTT and ZHA, plus why a device never appears.

Aqara's H1 name spans seven wall-switch SKUs, a mini switch, a remote, and two rotary knobs. How to identify which model you actually own.

Zigbee2MQTT names multi-gang switch entities switch_l1, switch_l2, or switch_left. What an endpoint is, why naming varies, and how to map each gang.

Pairing, entities, decoupled mode, and Zigbee2MQTT setup for the Aqara H1 no-neutral triple switch (QBKG29LM), and how it differs from the with-neutral version.

The Aqara H2 EU switch (WS-K07E) ships in Thread mode by default, but Zigbee2MQTT exposes more config. Here's how to pick a protocol and pair it locally.

Pair the Aqara ZNXNKG01LM wired rotary knob with Zigbee2MQTT, control all three relay loads in Home Assistant, and use rotation events in automations.

Pair the Aqara QBKG23LM neutral-wire switch to Zigbee2MQTT, get power monitoring into HA, and avoid the router-vs-end-device bug that broke early setups.

Pair the Aqara WS-EUK02 double-rocker no-neutral switch with Zigbee2MQTT and Home Assistant. Covers decoupled mode, anti-flicker, the operation_mode bug, and signal loss.

Set up the Aqara H1 EU single-rocker switch (WS-EUK03) with Zigbee2MQTT and Home Assistant — pairing, decoupled mode, power monitoring, and the action-not-firing bug.

How to pair the Aqara WS-EUK01 with Zigbee2MQTT and Home Assistant, fix LED flicker, set decoupled mode, and work around the known operation_mode bugs.