2026.10.1
Home ▸ Integrations

Modern Forms

Modern Forms has a line of smart Wi-Fi-connected fans that allow for cloud or local control of the fan and light. On fan models that support sleep timers, individual timers for the fan and light can be set and cleared independently.

Configuration

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

Modern Forms 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:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Modern Forms.

  • Follow the instructions on screen to complete the setup.

Note

If the Modern Forms fan does not have a light unit installed, then the Light entities and actions will not show up.

Fans

The Modern Forms integration has support for the Modern Forms fans. This includes directional support, and sleep timer actions for the fan.

Fan models with breeze hardware also support the Breeze preset mode, which varies the fan speed for a more natural airflow. Select Normal to return to a steady fan speed. Turning the fan off does not clear the preset mode. If Breeze was active, it resumes the next time you turn the fan on. This preset mode is not available on fan models without breeze hardware.

Lights

The Modern Forms integration supports the fan’s light, including brightness and sleep timer actions.

Some fan models have more than one light fixture, such as a separate uplight and downlight. Each fixture gets its own light entity that you can control independently, using the name you gave it in the Modern Forms app.

Light fixtures that support a range of color temperatures let you adjust the color temperature from the light entity, alongside the brightness.

Binary sensors

On fan models that support sleep timers, the Modern Forms integration provides binary sensors for the following information:

  • Fan sleep timer active status
  • Light sleep timer active status

These entities are not available on fan models without sleep timer support.

Buttons

The Modern Forms integration provides a Restart button to reboot the fan.

Numbers

On fan models with breeze hardware, the Modern Forms integration provides a number entity to configure the following setting:

  • Breeze intensity - how much the fan speed fluctuates while the breeze preset is active. Range: 1-3.

This entity is not available on fan models without breeze hardware.

Sensors

On fan models that support sleep timers, the Modern Forms integration provides sensors for the following information:

  • Fan sleep timer time expiring
  • Light sleep timer time expiring

These entities are not available on fan models without sleep timer support.

Switches

The Modern Forms integration provides support for the following toggleable attributes of a fan:

  • Away mode - to allow the fan simulate someone being home.
  • Adaptive learning - for allow learning for away mode.

The adaptive learning switch is not available on fan models without adaptive learning support.

List of actions

The Modern Forms integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

  • Clear fan sleep timer (modern_forms.clear_fan_sleep_timer) Clears the sleep timer on a Modern Forms fan.

  • Clear light sleep timer (modern_forms.clear_light_sleep_timer) Clears the sleep timer on a Modern Forms fan light.

  • Set fan sleep timer (modern_forms.set_fan_sleep_timer) Sets a sleep timer on a Modern Forms fan.

  • Set light sleep timer (modern_forms.set_light_sleep_timer) Sets a sleep timer on a Modern Forms fan light.

For an overview of every action across all integrations, see the actions reference.

Note

Modern Forms fans use NTP (via pool.ntp.org) to set their internal clock and check whether sleep timers have expired. Sleep timers only work if your fan can reach an NTP server on the internet. You can block cloud access for the fan and allow only outbound NTP (UDP port 123) so sleep timers keep working.

Troubleshooting

On rare occasions, a fan can report a status that doesn’t match reality, such as showing as off while still running. If a fan seems unresponsive or its state doesn’t match what you see, select the Restart button and give the fan a minute or two to reconnect rather than assuming it’s back right away. If that doesn’t help, power-cycling the fan at the breaker or switch usually does.