Home Assistant Dimmer Switch: Dimming, Scenes & Automations

 

Introduction

A Home Assistant dimmer switch can do more than turn lights on and off. It lets you set different brightness levels for night lights, cooking, movie time, bedtime, and other daily routines.

But choosing a dimmer switch is not as simple as choosing a regular smart switch. You need to check whether your lights are dimmable, whether the dimmer matches your wiring and load range, and whether Home Assistant can expose brightness control after pairing.

This guide explains how Home Assistant dimmer switches work, how to choose between smart dimmers, smart bulbs, and in-wall dimmer modules, and how to use them for practical lighting automations.

 

 

Quick Answer: Can You Use a Dimmer Switch with Home Assistant?

Yes. Home Assistant can control many smart dimmer switches through ZHA, Zigbee2MQTT, Matter, Z-Wave, or supported Wi-Fi integrations. After setup, the dimmer should ideally appear as a light entity with on/off and brightness control, not just as a basic switch.

Before choosing one, check whether your lights are dimmable, whether the load and wiring match the dimmer, and whether the integration exposes brightness control in Home Assistant.

For most users, the right protocol depends on the system you're already using: Zigbee is a good fit for local control, responsive automations, mesh networking, and broad smart home device support. Matter makes pairing easier with a QR code or setup code and works well for cross-platform setups. Wi-Fi depends on the brand integration, while Z-Wave is a local mesh option that usually costs more and has fewer dimmer choices.

 

 

What a Home Assistant Dimmer Switch Actually Does?

A smart dimmer switch lets you turn lights on and off and adjust brightness. Unlike a regular smart switch, it is not limited to basic on/off control — it lets you set the right brightness for different rooms, times of day, and routines.

It is also different from a traditional wall dimmer. You can still use the wall switch, but once it is added to Home Assistant, you can also control it from the dashboard, include it in scenes, and use it in automations.

With Home Assistant, a dimmer switch can be used for:

• Local lighting control, especially with Zigbee dimmers connected through ZHA or Zigbee2MQTT.
• Automations with motion sensors, presence sensors, wireless buttons, and other smart home devices.
• Brightness-based scenes, such as movie mode, bedtime lighting, or low-brightness night lights.
• More comfortable daily lighting, such as soft hallway lights at night, brighter kitchen lights while cooking, and dimmed living room lights for TV time.
• Optional power monitoring, if the dimmer model exposes energy data in Home Assistant.

 

 

Smart Dimmer Switch vs Smart Bulbs: Which Should You Choose?

Before choosing a Home Assistant dimmer switch, decide what kind of lighting control you need. In most homes, the choice comes down to three options: a smart dimmer switch, smart bulbs, or an in-wall dimmer module.  

Choose a smart dimmer switch if...

• You want to keep physical wall control, so family members, guests, or anyone else can still use the switch normally.
• One switch controls several dimmable lights, such as recessed lights or spotlights..
• You mainly need brightness control, not RGB color or advanced color temperature effects.
• You want to add existing dimmable lights to Home Assistant without replacing every bulb.

Choose smart bulbs if...

• You need RGB color, tunable white, or decorative lighting effects.
• You're renting and can't modify the wiring or replace the wall switches.
• You want to control each bulb separately, such as different bulbs in the same fixture or room.

Choose an in-wall dimmer module if...

• You want to keep the existing wall switch or decorative panel, with the dimmer module hidden behind it.
• Your wall box has enough space for a hidden module.
• You're upgrading an existing single-gang or multi-gang switch box without replacing the entire faceplate.  

👉 Quick takeaway: Choose a smart dimmer switch for wall-based brightness control, smart bulbs for color and individual bulb control, and an in-wall dimmer module if you want smart dimming behind your existing switch.

 

 

Which Protocol Should You Choose for a Home Assistant Dimmer Switch?

Before checking wiring or load specs, make sure the dimmer fits your current Home Assistant setup. The protocol affects how the device is added, whether it can run locally, and which features appear after pairing.

• Zigbee: A good choice if you already use ZHA or Zigbee2MQTT. It supports local control and mesh networking, but requires a Zigbee coordinator.
• Matter: Useful if you want easier cross-platform pairing, usually by scanning a QR code or entering a setup code. It can work with Home Assistant and other Matter-compatible platforms, but available features may vary by device.
• Wi-Fi: Easy to connect to your existing router without a hub, but Home Assistant support depends on the brand integration. Check whether the manufacturer provides an official integration or a community-supported integration.
• Z-Wave: A stable local mesh option if you already use Z-Wave. Compared with Zigbee, Wi-Fi, and Matter options, Z-Wave dimmers usually have fewer mainstream choices and may cost more.

 

 

What to Look For Before Buying a Home Assistant Dimmer Switch?

Before buying one, make sure it fits your lights, wiring, wall box, and Home Assistant setup. 

Dimmable Lights & Lamp Type Compatibility

Not every LED bulb or fixture can be dimmed. Check whether your lights are clearly labeled as dimmable and whether the dimmer supports your lamp type, such as dimmable LED, incandescent, halogen, or electronic transformer lights.

The dimming method should also match your lights. For many modern dimmable LEDs, trailing-edge dimming is usually a better fit.

Load Range & Rated Power

Before buying, check:

• Supported load range: Make sure the lights fall within the dimmer's supported power range.
• Maximum power by lamp type: LED, incandescent, halogen, and electronic transformer lights may have different power limits.
• Total wattage: Make sure the total wattage of all lights on the same switch stays below the dimmer's rated limit.
• Rated voltage: Make sure it matches your local voltage standard, such as 100–120V or 220–240V.

Tip: Try to leave some headroom instead of running the dimmer close to its maximum rating.

Neutral Wire Requirement

If there is no neutral wire in your switch box, choose a dimmer that is clearly rated for no-neutral wiring. If a neutral wire is available, you usually have more options.

Neutral-wired dimmers often have a more stable power supply for the smart module itself. Depending on the model, this may help support lower loads, more stable operation, or additional features.

Wall Box Size & Space

Wall box size matters, especially for in-wall dimmer modules like MINI-ZBDIM or MINI-DIM. If the box is too shallow or crowded with wires, the module may not fit behind the existing switch.

Before buying, check the wall box depth, available space, and local wall box type.

Useful Features to Look For

Some dimmers also offer useful features such as brightness calibration, power monitoring, external switch support, and safety protection against overload, overcurrent, or overheating. Check which features are supported in Home Assistant before buying.  

 

 

How to Add a Dimmer Switch to Home Assistant?

The setup process depends on the protocol your dimmer switch uses.

Zigbee dimmers can usually be added via ZHA or Zigbee2MQTT; Matter dimmers can be added through Home Assistant's Matter integration, and Wi-Fi dimmers may use Matter, an official brand integration, or a community integration.  

Add a Zigbee dimmer switch via ZHA or Zigbee2MQTT

For ZHA (Zigbee Home Automation), connect a Zigbee coordinator to Home Assistant, open Settings > Devices & services > ZHA, click Add device, and put the dimmer into pairing mode.

For Zigbee2MQTT, make sure the MQTT broker and Zigbee2MQTT are running, enable Permit join in Zigbee2MQTT, then put the dimmer into pairing mode, and wait for the device to appear in Zigbee2MQTT.

After pairing, check which features are exposed, such as on/off control, brightness, calibration, or power monitoring.  

👉 For detailed steps, see: How to Add Zigbee Devices to Home Assistant Via ZHA or Zigbee2MQTT

 

Add a Matter dimmer switch to Home Assistant

Basic steps:  

1. Make sure Home Assistant Matter integration is ready.
2. Put the dimmer into pairing mode.
3. Open the Home Assistant Companion App on your phone.
4. Scan the Matter QR code on the dimmer or enter the setup code.
5. Assign the device to a room and rename it if needed.
6. Test on/off and brightness control in Home Assistant.  

👉 How to Add Matter Devices to Home Assistant

 

Add a Wi-Fi dimmer switch to Home Assistant

Wi-Fi is a network connection method, but it does not define how the device communicates with Home Assistant. That means Wi-Fi dimmers may use different integration paths depending on the brand and model.  

Common integration options include:  
● Matter — if the Wi-Fi dimmer supports the Matter smart home standard.
● Official brand integrations — if provided by the manufacturer.  
● HACS community integrations — if there is no official integration but reliable community support is available.

Some Wi-Fi dimmers may only expose limited features, depending on the integration. Before building automations, check whether brightness control is available.  

👉 For SONOFF Wi-Fi devices, see: How to Add SONOFF Wi-Fi Devices to Home Assistant

 

What Should You See After Setup?

After setup, a dimmer switch should ideally provide:
● A light entity in Home Assistant
● On/off control
● A brightness slider on the dashboard
● Brightness control in scenes and automations
● Support for actions such as light.turn_on
● Brightness percentage control, such as 25%, 50%, 75%, or 100%.

Note: If the device only appears as a basic on/off switch, the integration may not expose brightness control for that dimmer model. Check that you are using the correct entity, and look for any required firmware updates, ZHA quirks, Zigbee2MQTT converters, or integration updates. 

 

 

Home Assistant Dimmer Automations for Daily Lighting

Once a dimmer switch appears in Home Assistant as a light entity with brightness control, you can use it in scenes and automations. Instead of turning lights on at full brightness every time, you can set different brightness levels for night lights, movie scenes, bedtime routines, and daily lighting.

Automation 1: Motion-Activated Night Light

What it does: Turns on a low-brightness light when motion is detected at night, so you can see without harsh lighting.

What it does: Use different brightness levels for daytime, evening, and late night — such as brighter during the day, dimmer in the evening, and lowest at night.

Trigger:

• Time of day, illuminance sensor, presence sensor, or sun position.

Action:

• Daytime: 80–100%
• Evening: 40–60%
• Late night: 5–20%

✅ Best for: Whole-home lighting, hallways, kitchens, bedrooms, living rooms, and home offices.

 

 

Recommended SONOFF Dimmer Switches for Home Assistant

SONOFF offers Zigbee and Matter dimmer options for different Home Assistant setups. Choose MINI-ZBDIM if you already use ZHA or Zigbee2MQTT. Choose MINI-DIM if you prefer Matter over Wi-Fi and do not want to add a Zigbee coordinator. EDIM is an enclosure accessory for users who want a cleaner wall switch finish.  

MINI-ZBDIM — Zigbee Dimmer Module for ZHA/Zigbee2MQTT

A smart Zigbee dimmer module for Home Assistant users who prefer ZHA or Zigbee2MQTT. It fits behind the wall switch, supports common dimmable lamp types, and works well for local Zigbee lighting automations.