The wilight integration is to integrate WiLight devices with Home Assistant.

There is currently support for the following device types within Home Assistant:

  • Cover (WiLight model C-103).
  • Fan (WiLight model V-104).
  • Light (WiLight model I-100, I-102 and I-107).


Adding WiLight to your Home Assistant instance can be done via the user interface, by taking the following steps:

  • Browse to your Home Assistant instance.
  • In the sidebar click on Configuration.
  • From the configuration menu select: Integrations.

WiLight can be auto-discovered by Home Assistant. If an instance was found, it will be shown in the top of the list of integrations as “Discovered”. If that is the case click on the Configure button to start setting up the discovered instance.

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

  • In the bottom right, click on the Add Integration button.
  • From the list, search and select “WiLight”.
  • Follow the instruction on screen to complete the set up.

After completing, the WiLight integration will be immediately available for use.


The wilight integration allows you to control your Fans from within Home Assistant.


There are several services which can be used for automations and control of the fan:

Service Description
set_percentage Calling this service sets the fan speed (entity_id and percentage are required parameters). Percentage must be in the range 0-100, percentage = 0 turns off the fan. There are three speed levels 33%, 66% and 100%. Adjusting to intermediate levels goes to the next higher level.
set_direction Calling this service will set the fan direction (entity_id and direction are required parameters, and direction must be one of the following: forward or reverse). Calling this service will turn the fan on.
toggle Calling this service will toggle the fan between on and off states (entity_id is required).
turn_off Calling this service will turn the fan off (entity_id is required).
turn_on Calling this service will turn the fan on and set the speed and direction to the last used ones (defaults to high and forward, entity_id is required).