Device settings
Plug settings
A plug is fundamentally a relay with power metering built into a plug shell - what sets it apart is the LED indicator and that there's usually no external input to configure.
A Shelly plug is technically a relay with power metering, built into a plug. initial_state, auto-on/off timers and power/voltage/current protection all work exactly as described in Common settings and Relay settings. What's different is the LED indicator, and that there's rarely an external physical input to wire in_mode to - the button sits on the plug itself.
LED indicator
The plug's LED has its own small settings block (PLUGS_UI in the Gen2+ documentation) that controls what the LED shows:
- Colour mode - whether the LED shows power state (on/off), follows the relay's state, or is turned off entirely.
- Night mode - dims or turns off the LED during a time window you set yourself, so it doesn't light up a bedroom. You set a start time, an end time, and the LED's brightness during that window.
Physical button on the plug
Most plugs have a physical button on the housing that toggles the relay directly, regardless of what's set in the app. It counts as the device's only "input" and generally has no mode settings of its own beyond that - it behaves as a simple momentary button.
Other
- Power metering, where the plug has it, works the same as on relays - see Common settings for
power_limit,voltage_limit,undervoltage_limitandcurrent_limit. - Cloud connection, Wi-Fi/failover, schedules and MQTT are identical to the rest of the Gen2+ range - nothing plug-specific there.