2024.12.5
Home ▸ Integrations ▸

WiZ

The WiZ integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control your WiZ lights and smart sockets. The devices are set up through your Wi-Fi network and don’t need any additional bridge or gateway.

These devices have been sold under at least the following brands:

The integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] can report the state of occupancy sensors that have been linked to a device.

Configuration

To add the WiZ integration to your Home Assistant instance, use this My button:

WiZ can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

Connect WiZ devices to your network

To connect a WiZ device to your Wi-Fi network, please follow the instructions in the WiZ app (available for iOS and Android). If you have further questions, please have a look at the WiZ Support Page.

Enable local connectivity

The integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] needs to communicate locally with the WiZ device. This setting Allow local communication can be disabled or enabled in WiZ app. This setting should be enabled by default.

Steps to enable:

  1. Open the WiZ app on your phone.
  2. Click on the settings menu in the upper-left corner.
  3. Scroll down to the security settings.
  4. Enable the switch Allow local communication.

Occupancy sensors

The occupancy sensors will only be added once a motion event is detected. Home Assistant can detect the sensors if they turn on at least one device when the room is occupied, and turn off at least one device when the room is not occupied. Sensors that are not linked to a device cannot be detected.

When a device is linked to an occupancy sensor, by default, the sensor will be disabled for 30 minutes after manual control.

Devices linked to the occupancy sensor that was last controlled manually will show an unknown at startup. The state will be known the next time the light is controlled by the sensor.

Power monitoring sensors

A power monitoring sensor is available on devices with the following hardware modules:

  • ESP25_SOCKET_01
  • ESP20_SHDW_31R
  • ESP20_SHRGB_31R
  • ESP20_SHTW_31R

Effect speed

The speed of an effect can be controlled via a number entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more]. The entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] will only be available when an effect has been set that allows the speed to be adjusted.