Shelly Wiki

Device settings

Where do device settings live?

Device settings live in two places - the app and the device's own web interface. What's available where depends on whether it's Gen1 or Gen2+.

This section covers settings on the device itself - how an output behaves after a power cut, which mode an input is in, protection against too much power, cloud connection, network, and so on. If you're instead looking for account and app settings (profile, email, subscription), see Settings - that's a different tab in the app, and a different thing.

Two interfaces, the same settings

Almost every device setting can be reached from two places:

  • The app. Open the device → the gear icon/Settings for that specific device. This is the path most people use, and it requires the device to be linked to your account (cloud, or locally over Bluetooth).
  • The device's own web interface. The device's local IP address in a browser, no app, no account, no internet. Some settings - especially the more technical ones, like scripts, KVS and advanced schedules on Gen2+ - only exist here.

The difference is mostly surface, not substance: the same underlying setting is usually reachable from both, but the web interface exposes more of the technical detail directly, while the app packages it a bit more explained.

Gen1 vs Gen2+

Which settings exist, and what they're called in the technical documentation, depends on which generation the device is:

Gen1 Gen2+ (Plus/Pro/Gen3/Gen4)
Interface behind the scenes URL/webhook-based RPC-based API, component by component (Switch, Cover, Input, Sys …)
Scripts, KVS, dynamic components Not available Available
Advanced schedules (cron) Not available Available
BTHome, Matter, KNX Not available Available on devices that support it

The rest of this section mostly uses Gen2+ terminology, since that's what applies to most of what's sold today. Where something only applies to Gen1, or only to Gen2+, that's spelled out.

Finding the right setting

If you roughly know what you're looking for, this section is organised by device type:

  • Common settings - what exists on nearly every device: power-on behaviour, input mode, timers, protection, cloud, network, MQTT, schedules, and more.
  • Relay settings - devices that switch a load on/off.
  • Dimmer settings - calibration, min/max level, fade.
  • Cover settings - calibration, obstruction protection, slat angle.
  • Plug settings - plug-in devices.
  • Input settings - standalone buttons/inputs, like the i3 and Plus i4.
  • BLU settings - battery-powered Bluetooth sensors, configured through a gateway.

Not sure your device even has the feature you're after? Start in the device database and compare.

Report an error on this page

Briefly describe what looks wrong — we read every report.