How it works
A Shelly i4 Gen3 sits behind a push-button switch. Each kind of press can run its own action on the i4: a push, a double push, a triple push or a long push. An action sends up to five commands straight to other Shelly devices over your Wi-Fi, so one push can dim the lounge to 20% and switch off the hallway.
The lights in the group need a Shelly. Any light already on a Shelly relay or dimmer works, and a Shelly Dimmer Gen4 puts one that isn't smart yet into the group.
A Shelly i4 Gen3 sits behind a push-button switch. In the Shelly app, a scene uses a press on the i4 as its trigger, then sets every light you add to it.
Scenes run in Shelly's cloud, so they need the internet, and they can include anything in your Shelly account. A Shelly Dimmer Gen4 puts a light that isn't smart yet into the group.
A Shelly i4 Gen3 sits behind a push-button switch and joins Home Assistant through the Shelly integration. Each press shows up as an event: a push, a double push, a triple push or a long push.
An automation for each one sets the lights you choose. They can be any brand Home Assistant controls, such as Philips Hue alongside Shelly.
-
01
Your switch
Press it, and the i4 behind it tells the lights what to do.
-
02
Your phone
Choose once which lights each press sets.
-
03
Your lights
The whole group changes together, in any room.
What it looks like on your phone
-
Every press. The i4's activity log lists each push and long push with its time.
-
Two actions, one button. A push runs Movie night and a long push runs All off, straight from the i4.
-
The lights follow. Hallway light's log shows it switching off on each Movie night and All off.
-
Your scenes. Movie night and All off sit with the room's other scenes, ready for the button.
-
Every press. The i4's activity log lists each push and long push that set off a scene.
-
The lights follow. Home Assistant's Activity shows each change and the automation that made it.
-
Your automations. Movie night and All off, with the last time each one ran.
Step by step
How you'll set it up
Add the device to Wi-Fi from your phone, or straight from a browser.
Every Shelly has its own built-in web interface, so there's nothing to install. Once it's on your Wi-Fi, type its IP address into a browser on the same network. Before it joins your Wi-Fi, connect your computer to the Shelly's own hotspot and open `192.168.33.1`.
-
Fit the i4 behind the button
Live goes to L and neutral to N. The push button takes live on one side and connects to SW1 on the other.
Wire map i4 Gen3- Active (supply) L
- Neutral N
- Push button SW1
Circuit overview1Push buttonActive (supply)Neutral / 0 VSwitch signal / dry contactIn Australia, fixed 230 V wiring is licensed-electrician work. Use these diagrams to plan the job and brief your electrician.
Showing the whole circuitThere's no wiring diagram for the here yet. Its installation guide has the manufacturer's wiring diagram. Wire it from the diagram in its manual.
-
Add the i4 and set it to Button
Add the i4 in the Shelly app and name it after the room, such as Living room switch. Open its Settings (the cog at the foot of the menu), then Input settings, choose Button and tap Save. In the web interface, open the input, then Input settings, set the mode to Button and click Save.
-
Set the lights for a push
Open Actions and tap Add action. Name it Movie night and tap Next twice. Under When, tap Button is pushed, then Next. Tap Add action from another device, pick a light and tap Next. For a dimmer, turn on Light State and choose On, then turn on Set Brightness property, set it to 20% and tap Save. Add the next light the same way (Hallway light, Control Output, Off) and tap Save, then Save again. In the web interface, open Actions, click Create action and set Event to Button push. Under Then do, click Add URL and add one per light: `http://` and the light's IP address, followed by `/rpc/light.set?id=0&on=true&brightness=20` for a dimmer at 20% or `/rpc/switch.set?id=0&on=false` for a relay. Then click Save.
-
Switch them all off with a long push
Add a second action named All off. Under When, tap Button is long pushed, then tap Next. Add each light with Off, then tap Save. In the web interface, set Event to Button long push and add the same URLs ending `on=false`, then click Save.
-
Check the actions
Actions now lists Movie night on Button is pushed and All off on Button is long pushed, each with two lights. A push sets the room and a long push switches it off. The web interface's Actions page shows the same two.
-
Fit the i4 behind the button
Live goes to L and neutral to N. The push button takes live on one side and connects to SW1 on the other.
Wire map i4 Gen3- Active (supply) L
- Neutral N
- Push button SW1
Circuit overview1Push buttonActive (supply)Neutral / 0 VSwitch signal / dry contactIn Australia, fixed 230 V wiring is licensed-electrician work. Use these diagrams to plan the job and brief your electrician.
Showing the whole circuitThere's no wiring diagram for the here yet. Its installation guide has the manufacturer's wiring diagram. Wire it from the diagram in its manual.
-
Add the i4 and set it to Button
Add the i4 in the Shelly app and name it after the room, such as Living room switch. Open its Settings (the cog at the foot of the menu), then Input settings, choose Button and tap Save.
-
Make a scene for a push
Open the room's Scenes and tap the + button, then Add condition and Create condition. Choose Device based and tap Next, pick the i4 and tap Next. Tap Button Push, then Short, and tap Next. Leave it as Trigger and tap Save.
-
Choose the lights
Tap Next, then Add action and Create action. Choose Device action, pick Lounge lights, turn on Change state with turn on Shelly device, turn on Brightness and set it to 20%, then tap Next and Save. Add Hallway light the same way with turn off Shelly device. Do now lists both: tap Next. Under More options, turn off Execute the scene on save or edit so saving doesn't run it, then name the scene Movie night and tap Save.
-
Make an all-off scene for a long push
Add a second scene the same way. Tap Button Push, then Long, and tap Next. Add both lights with turn off Shelly device and name it All off.
-
Check the scenes
The room's Scenes now lists Movie night and All off. A short push runs one and a long push the other.
-
Fit the i4 behind the button
Live goes to L and neutral to N. The push button takes live on one side and connects to SW1 on the other.
Wire map i4 Gen3- Active (supply) L
- Neutral N
- Push button SW1
Circuit overview1Push buttonActive (supply)Neutral / 0 VSwitch signal / dry contactIn Australia, fixed 230 V wiring is licensed-electrician work. Use these diagrams to plan the job and brief your electrician.
Showing the whole circuitThere's no wiring diagram for the here yet. Its installation guide has the manufacturer's wiring diagram. Wire it from the diagram in its manual.
-
Add it to Home Assistant
In Home Assistant, go to Settings, then Devices & services, select Add integration and choose Shelly. Enter the i4's IP address, which your router lists, and select Submit. Name it Living room switch. Each kind of press on its first button is then a trigger you can pick.
-
Set the lights for a push
Go to Settings, then Automations & scenes, and select Create automation. Select Add trigger, choose Device, pick Living room switch and choose First button single push. Then add the actions: Turn on light for Lounge lights, with Brightness ticked and set to 20%, and Turn off switch for Hallway light. Tap Close on the action, then Save, and name it Movie night.
-
Switch them all off with a long push
Create a second automation with First button long push as the trigger and a turn-off action for each light. Select Save and name it All off.
-
Check it's there
Automations & scenes now lists Movie night and All off. They're on as soon as you save them, so the next press sets the lights.
Frequently asked questions
Which should I use: the i4, a Shelly scene or Home Assistant?
If every light in the group is a Shelly, set it up on the i4: it works without the internet. A Shelly scene can reach more of your Shelly account but needs the internet. If Home Assistant runs your home, or the group includes other brands such as Philips Hue, use Home Assistant.
Do I need a push button rather than a normal switch?
Yes. A push, a double push and a long push all need a button that springs back. A normal rocker switch stays on or off, so it can only do one thing each way.
Does the switch box need a neutral?
Yes. The i4 is powered from live and neutral, so the box needs both.
Does it work if the internet drops out?
No. Shelly scenes run in Shelly's cloud. If you want the switch to keep working without the internet, set it up on the i4 instead.
How many lights can one press set?
Up to five commands per action, and each press type has its own action. For a bigger group, use a Shelly scene or Home Assistant.
Does it work while Home Assistant is down?
No. The automations run in Home Assistant, so the button does nothing until it's back.
More Shelly solutions
Add a second light switch without running new cable
A Shelly i4 behind a second switch tells the light to change over Wi-Fi, so the far end of the hall or the top of the stairs gets its own switch. Nobody runs cable between the two. Control with any of
Dim the lights from the couch for movie night
Drop the lights to a glow from the couch, then bring them back up when it's time to tidy. Fit a Shelly dimmer behind the wall plate, or swap to Philips Hue bulbs and use the app. Control with any of 
Lights that dim on a schedule each evening
The lights fade down to a low glow after dinner instead of snapping between full and off. Do it with a Shelly dimmer behind the wall plate or Philips Hue bulbs, in their app or Home Assistant. Control with any of More Shelly solutions
Add a second light switch without running new cable
A Shelly i4 behind a second switch tells the light to change over Wi-Fi, so the far end of the hall or the top of the stairs gets its own switch. Nobody runs cable between the two. Control with any of Dim the lights from the couch for movie night
Drop the lights to a glow from the couch, then bring them back up when it's time to tidy. Fit a Shelly dimmer behind the wall plate, or swap to Philips Hue bulbs and use the app. Control with any of Lights that dim on a schedule each evening
The lights fade down to a low glow after dinner instead of snapping between full and off. Do it with a Shelly dimmer behind the wall plate or Philips Hue bulbs, in their app or Home Assistant. Control with any of More Home Assistant solutions
Add a second light switch without running new cable
A Shelly i4 behind a second switch tells the light to change over Wi-Fi, so the far end of the hall or the top of the stairs gets its own switch. Nobody runs cable between the two. Control with any of Dim the lights from the couch for movie night
Drop the lights to a glow from the couch, then bring them back up when it's time to tidy. Fit a Shelly dimmer behind the wall plate, or swap to Philips Hue bulbs and use the app. Control with any of Lights that dim on a schedule each evening
The lights fade down to a low glow after dinner instead of snapping between full and off. Do it with a Shelly dimmer behind the wall plate or Philips Hue bulbs, in their app or Home Assistant. Control with any of Still need a hand?
We answer most messages within one business day. If your question is about an existing order, have your order number ready. It speeds things up.
Contact us