Skip to main content
Skip table of contents

Shelly Plus Uni web interface guide

Overview

Shelly devices provide a local web interface to control and configure your devices through a standard web browser on either your computer or mobile device. Its functionality encompasses an array of adjustment and control features, including the ability to power your device on or off, set schedules and configure actions to be executed when certain conditions are met, configure the device and much more.

Note that you do not need internet connection or Shelly Cloud to use the local web interface - the only requirement is that your browser must be in the same WiFi network as your Shelly device.

Accessing the web interface

For devices with an access point:

  1. Connect your device to a Wi-Fi network with a name (SSID) that follows this format: "DeviceName-XXXXXXXXXX", where ‘DeviceName’ is the name of the device you’d like to connect to, while 'XXXXXXXXXX' represents a unique combination of letters and numbers, constituting the device ID. For instance, the SSID might appear as "ShellyPlus1PM - 84CCA87D7CDC”.

  2. After establishing a connection to the device’s Access Point / AP (the Wi-Fi network mentioned in step 1), accessing the web interface is done by entering the universal IP address for all Shelly devices 192.168.33.1 in your browser.

For Wi-Fi devices without an access point:

  1. Connect the device to your Wi-Fi network.

  2. While you’re connected to that network, go to the IP address shown on your device.

You are now in the web interface of your device.

Connecting your device to a Wi-Fi network

Some of the settings you’ll see in the web interface are only available if the device is connected to the internet. To do that, follow these steps:

  1. From the Web interface, navigate to Settings>Wi-Fi.

  2. Either input or select your preferred Wi-Fi network and then enter its password. Alternatively, connecting to an open network is also an option, facilitated by selecting the checkbox for connecting to open Wi-Fi networks. Additionally, it is recommended to set a static IP address.

  3. Allow your device a few seconds, so it can try to connect to the Wi-Fi network you provided. If the password you typed in is incorrect, or the Wi-Fi network lacks sufficient strength or stability, a message will be displayed in the web interface, notifying you that a connection couldn’t be established. Upon successful connection to the Wi-Fi, a link, containing the new IP address will appear as text above the Wi-Fi settings. Simply copy and paste this link into your browser.

You are now in the web interface of your internet-connected device. The next time you need to access the web UI, simply connect to the same Wi-Fi network as your device and type in the new IP address, obtained in step 3. Setting a static IP address is recommended because it guarantees consistent accessibility at that specific address.

Understanding the layout

The web interface can be divided into four main sections - the header, footer, main menu, and main content.

Header

The header consists of two components - the name of your device on the left and a few icons, which display your device’s main network and connectivity features on the right. These icons can encompass functionalities such as Wi-Fi, Bluetooth, MQTT, and more, as well as an icon that shows if there are any new firmware updates for your device. Hovering with your mouse on an icon will provide you with further information. You’ll find a legend with the meaning of each icon in the web interface guide of each device. Please note that the individual guides explain only the connectivity features available for that specific device.

At the bottom of the screen from left to right in order are the device model name, its ID, the version of the web interface, the firmware version of the device and finally, the current time. Some previous versions of the web interface do not include all of these components.

Main menu

The main menu in the desktop version of the web interface is on the left, whereas on mobile, it looks like a hamburger menu with an icon of three horizontal lines, stacked on top of each other. The menu contains different things, depending on the device, but clicking an item from it takes you to a different page. You can also use it to get back to the Home page by clicking Home.

Main content

By clicking on an item from the main menu, you’ll be able to navigate through the web interface. Everything that you see on the screen, excluding the header, footer, and main menu is considered main content.

*Please note that not all of the web interface screenshots displayed at the top of each web interface guide page (where there is a screenshot present) are of the latest version. Therefore, they may look a bit different than the latest version and may not represent the look of every device's web interface.

Main Menu

Below are explanations of each setting in the main menu, including what is visualised as main content upon clicking on the different settings. A brief introduction of the icons in the header, specific to this device, is also present in the Home page explanation. Note that the header is present in all of the screens, not just the Home page.

Home page

In the web interface, you will see five icons in the header, including one for AP, Wi-Fi, Bluetooth, Cloud, and MQTT connection. Here is what the different status colors mean:

  • AP icon :

    • Gray: AP mode is disabled.

    • Blue: AP mode is enabled.

  • Wi-Fi icon :

    • Gray: Wi-Fi connection is disabled.

    • White: Wi-Fi connection is enabled, but not established.

    • Blue: The device is connected to Wi-Fi.

  • Bluetooth icon :

    • Gray: Connection is disabled.

    • Blue: Connection is enabled.

  • Cloud icon :

    • Gray: Connection to Shelly Cloud is disabled.

    • White: Connection to Shelly Cloud is enabled, but not established.

    • Blue: The device is connected to Shelly Cloud.

  • MQTT icon :

    • Gray: MQTT is disabled.

    • Blue: MQTT is enabled.

package.png
  • Firmware update icon:

    • Blue: There is a new stable version of the firmware for your device.

    • Doesn’t appear: The device’s firmware is up to date.

You will see the output and input in the home page. Next to the output(it’s labelled as output, but the name can be changed in the settings) is a power button, which controls it, and under the output is the attached input. Detached inputs, as well as peripherals, are also visible in this page.

Output Settings

Upon clicking on the displayed output in the home page, you’ll be taken to a menu with settings, specific to the output.

Name

Name/rename the output.

Input/output settings

Select input mode:

  • Button - every button press toggles the state of the device output.

  • Switch - the position of the switch corresponds to the state of the device output.

  • Analog (not present as an option in all devices)- using the Analog input, the device determines its brightness percentage based on the percentage of the input.

Set output type:

  • Toggle Switch (Switch only) - The device will act as a flip switch with one state for ON and one for OFF. If the Input is in Analog mode, the device will follow the analog input’s state.

  • Momentary Switch (Button only) - Every push of the button toggles the state of the device output. If your switch is ON, it will turn OFF, and vice versa.

  • Edge Switch (Switch only) - Each change of the switch’s position toggles the state of the device output.

  • Detached Switch - The input becomes detached (separated) from the output and doesn’t have an effect on it. Essentially, you won’t be able to control your light through the input.

Action on power on:

This setting is usually used when a power outage occurs and “power on” refers to when the electricity is restored and the device is powered again.

  • Turn ON - When powered, the device will turn on.

  • Turn OFF - When powered, the device will be off.

  • Restore last known state of output/relay - When powered, the output’s state will be as it was the last time the device was ON (before the power loss).

  • Current state of the switch (Toggle Switch only) - Follows the state of the switch, so if it’s flipped to ON, the device will turn on and the same applies when the switch is flipped to OFF.

Consumption type

This setting is relevant when integrating the device with third-party home automation systems. The purpose is to specify the necessary information or configuration required by the external system to interact with the device.

When you are using third-party home automation systems to control your device, it is recommended to refer to their documentation or user guide to determine what needs to be entered in this field. The documentation of the third-party system will typically outline the required parameters, credentials, or any other details that should be provided to establish communication between itself and the Shelly device.

However, if you are using the device exclusively with the Shelly app, you can disregard the External consumption type field. The app does not require any additional configuration in this regard, as it has its own built-in mechanisms for communicating with and controlling the device.

If, for any reason, you wish to remove or delete the external consumption type from the device's settings, you can do so by simply leaving the External consumption type field empty and clicking the Save settings button. By doing this, you effectively disable the external consumption type and revert to the device's default behavior or rely solely on the Shelly app for control and automation.

Automations:

Actions

Configure the actions for your device - create new actions, edit existing actions, or delete actions. When creating actions for your device you will need to specify the condition on which the action occurs. You can also set a duration for your actions, as well as a URL to be hit when the condition for the action is met.

Schedules

This function requires a working connection to the Internet, so the device can synchronize the time. It allows you to create, view, edit, and delete schedules.

There are two types of schedules: Basic and Advanced.

To create a basic schedule:

  • Select the day(s) of the week.

  • Choose a time interval: time, sunrise, or sunset.

  • Set the time for the specified day(s):

    • Time: Click the up/down button, or type in a number, to set a time in hours and minutes.

    • Sunset/Sunrise: The Shelly device may turn on/off (or do specified action) automatically at sunrise/sunset, or at a specified time before or after sunrise/sunset. Click the up/down button, or type in a number, to set a time in hours and minutes.

To create an advanced schedule:

The advanced schedule function uses cron to execute jobs with a single schedule, instead of using a few basic schedules.

Creating an advanced schedule differs from creating a basic schedule, because of the When to execute menu.

It prompts you to select one or multiple values, a range of values, or a step between values (Choose one of the three by clicking on the Select, Range, or Step button for each value) for:

  • Seconds (0-59)

  • Minutes (0-59)

  • Hours (0-23)

  • Days (1-31)

  • Months (JAN-DEC)

  • Weekdays (SUN-SAT)

To create a schedule that happens every second/minute/hour/day/month/weekday, simply tick the box below the values in the desired section (seconds, minutes, hours, days, months, or weekdays). Additionally, you can use the sunrise/sunset offset by ticking the box next to this option. Doing so will bring up a new menu with hours and minutes. Leaving the hours and minutes and selecting either sunrise or sunset will make the schedule occur exactly at sunrise or sunset. Changing the hours and minutes values will create an offset, so entering negative values will make the schedule occur exactly [set hours and/or minutes] before sunrise/sunset while entering positive values will make the schedule occur [set hours and/or minutes] after sunrise/sunset. You cannot enter a positive value for one (hours/minutes) and a negative value for the other.

After that, simply specify the action you want your device to perform in the Do what section. Click Save once you’re done to save the new schedule.

Timers

Allows you to manage the power supply automatically. You may use:

  • Auto on: After turning off, the relay output will be automatically turned on after a predefined period of time (in seconds).

  • Auto off: After turning on, the relay output will be automatically turned off after a predefined period of time (in seconds).

Input settings

Name

Name/rename the input.

Input/output settings

Select input mode:

  • Button - every button press toggles the state of the device output.

  • Switch - the position of the switch corresponds to the state of the device output.

  • Analog (not present as an option in all devices)- using the Analog input, the device determines its brightness percentage based on the percentage of the input.

Set output type:

  • Toggle Switch (Switch only) - The device will act as a flip switch with one state for ON and one for OFF. If the Input is in Analog mode, the device will follow the analog input’s state.

  • Momentary Switch (Button only) - Every push of the button toggles the state of the device output. If your switch is ON, it will turn OFF, and vice versa.

  • Edge Switch (Switch only) - Each change of the switch’s position toggles the state of the device output.

  • Detached Switch - The input becomes detached (separated) from the output and doesn’t have an effect on it. Essentially, you won’t be able to control your light through the input.

Action on power on:

This setting is usually used when a power outage occurs and “power on” refers to when the electricity is restored and the device is powered again.

  • Turn ON - When powered, the device will turn on.

  • Turn OFF - When powered, the device will be off.

  • Restore last known state of output/relay - When powered, the output’s state will be as it was the last time the device was ON (before the power loss).

  • Current state of the switch (Toggle Switch only) - Follows the state of the switch, so if it’s flipped to ON, the device will turn on and the same applies when the switch is flipped to OFF.

Invert

This setting allows you to invert the logic of the input signal, effectively reversing the behavior of the device. By default, when the input signal is ON, the device responds by turning ON. When the input signal is OFF, the device turns OFF.

However, if you enable the "Invert Input" setting, the opposite will occur. When the input signal is ON, the device will turn OFF, and when the input signal is OFF, the device will turn ON. This setting can be useful in situations where the device's behavior needs to be reversed.

Detached input settings

The detached input has different settings than the attached inputs.

Name

Name/rename the input.

Enable

Enable/disable the detached input.

Report threshold

The report threshold is the number of pulses counted by the device before it sends a report through webhooks, actions, MQTT, or another channel.

Frequency window

Set a time interval in seconds for how often the device measures the frequency of the pulses.

Frequency report threshold

Input a percentage value. The device will send a report through webhooks, actions, MQTT, or another channel, once the frequency change has reached the set amount.

Custom count expression

Set a custom mathematical expression (formula), and a custom unit. The current value is x or X and can be used in the expression to produce a custom value. Both of the values (the expression and the custom unit) need to be set for this setting. By clicking on the Example formulas text below the text fields, you’ll be able to view different ways to use this setting.

Custom frequency expression

Set a custom mathematical expression (formula), and a custom unit. The current value is x or X and can be used in the expression to produce a custom value. Both of the values (the expression and the custom unit) need to be set for this setting. By clicking on the Example formulas text below the text fields, you’ll be able to view different ways to use this setting.

Reset counters

Sets all input readings to 0.

Adding peripherals

Adding peripherals is done by going to the Peripherals setting in the web UI of your device and clicking the + button. You will then be prompted to pick the type of peripheral you’d like to add. If you have properly connected your peripheral(s) and have selected the correct type of peripheral from the menu that pops up, your peripheral will appear under the name of the type of peripheral you’ve selected. You can click Rescan under the selected peripheral type to scan for that type again. Tick the peripheral you’d like to add and click the Add button to add it or click Add and reboot to trigger a device reboot after adding your peripheral.

The list of peripherals includes:

  • Temperature and Humidity (DHT22)

  • Temperature (DS18B20)

  • Digital Input

  • Analog Input

  • Voltmeter

A message notifying you if your device needs to reboot will pop up on the top part of your screen with a Reboot button.

Peripherals menu

If you have successfully added all of your peripherals, your Peripherals menu should display them. It should look similiar to the image below, except instead of the temperature sensor, your added peripherals should be displayed in this page. There is a trash can icon next to each peripheral, which will remove the peripheral and all of its actions. You can add it again, but you cannot retrieve the actions or the customised settings you may have had before. The pencil icon allows you to edit the peripheral.

plusuniperipherals.png

Each peripheral has a unique set of settings, explained below. You can access them by clicking on the peripheral in the Peripherals menu.

Temperature and Humidity (DHT22)

Temperature settings

  • Name - Set the peripheral’s name, which you’d like it to be displayed with.

  • Delta Threshold - Temperature change with more than the specified value in Celsius triggers sensor data report. The minimum is 0.1℃ and the maximum is 5℃.

  • Offset - A value, which will be added (if positive) and subtracted (if negative) from the temperature readings to make them more accurate.

Humidity settings

  • Name - Set the peripheral’s name, which you’d like it to be displayed with.

  • Delta Threshold - Relative Humidity change with more than the specified value triggers sensor data report. The minimum is 1% and the maximum is 20%.

  • Offset - A value, which will be added (if positive) and subtracted (if negative) from the humidity readings to make them more accurate.

Actions

Create and edit actions. When creating an action, there are a few things you will be asked to specify:

  • Active time - A period of time in the 24 hours of the day that the action is allowed to be triggered.

  • Execute when - Only after a temperature change or every 60 seconds.

  • Condition - Specify when you’d want the action to occur. You can choose less than or greater than a certain value to make the action occur when the temperature drops below or rises above the value depending on what you choose.

  • Then do - Using URLs and local actions, specify what you want the device to do when the condition is met. You can send internal or external URLs, which means you can send URLs to this device, or to another device.

Make sure to press the Save action button if you’re editing or creating an action.

Temperature(DS18B20)

Overview - displays the sensor’s readings (the temperature).

Temperature settings

  • Name - Set the peripheral’s name, which you’d like it to be displayed with.

  • Delta Threshold - Temperature change with more than the specified value in Celsius triggers sensor data report. The minimum is 0.1℃ and the maximum is 5℃.

  • Offset - A value, which will be added (if positive) and subtracted (if negative) from the temperature readings to make them more accurate.

Actions

Create and edit actions. When creating an action, there are a few things you will be asked to specify:

  • Active time - A period of time in the 24 hours of the day that the action is allowed to be triggered.

  • Execute when - Only after a temperature change or every 60 seconds.

  • Condition - Specify when you’d want the action to occur. You can choose less than or greater than a certain value to make the action occur when the temperature drops below or rises above the value depending on what you choose.

  • Then do - Using URLs and local actions, specify what you want the device to do when the condition is met. You can send internal or external URLs, which means you can send URLs to this device, or to another device.

Make sure to press the Save action button if you’re editing or creating an action.

Digital input

Overview - displays the readings.

Input settings

  • Name - Change the name of the input.

  • Mode - Select Switch or Button.

  • Invert - Enable invert input. On state is considered off and vice versa.

  • Factory reset - Enable your device to be factory reset through the Add-on’s digital input.

Actions

Create and edit actions. When creating an action, there are a few things you will be asked to specify:

  • Active time - A period of time in the 24 hours of the day that the action is allowed to be triggered.

  • Execute when - You can either execute the action when the input is toggled on or off.

  • Then do - Using URLs and local actions, specify what you want the device to do when the condition is met. You can send internal or external URLs, which means you can send URLs to this device, or to another device.

Make sure to press the Save action button if you’re editing or creating an action.

Analog input

Overview - displays the readings of the Analog input in percentage.

Settings

  • Name - Set the peripheral’s name, which you’d like it to be displayed with.

  • Delta Threshold - The input percentage change with more than a specified value, which triggers a data report. The minimum is 1% and the maximum is 50%.

Actions

Create and edit actions. When creating an action, there are a few things you will be asked to specify:

  • Active time - A period of time in the 24 hours of the day that the action is allowed to be triggered.

  • Execute when - The only possibility for an action to be executed is when there's an analog state change.

  • Condition - Specify when you’d want the action to occur. You can choose less than or greater than a certain value to make the action occur when the percentage drops below or rises above the value depending on what you choose.

  • Then do - Using URLs and local actions, specify what you want the device to do when the condition is met. You can send internal or external URLs, which means you can send URLs to this device, or to another device.

Make sure to press the Save action button if you’re editing or creating an action.

Voltmeter

Overview - displays the voltage.

Settings

  • Name - Set the peripheral’s name, which you’d like it to be displayed with.

  • Delta Threshold - The voltage change with more than a specified value, which triggers a data report. The minimum is 0.1 and the maximum is 5.

Actions

Create and edit actions. When creating an action, there are a few things you will be asked to specify:

  • Active time - A period of time in the 24 hours of the day that the action is allowed to be triggered.

  • Execute when - Execute every 60 seconds or when the state of the voltmeter has changed.

  • Condition - Specify when you’d want the action to occur. You can choose less than or greater than a certain value to make the action occur when the voltage drops below or rises above the value depending on what you choose.

  • Then do - Using URLs and local actions, specify what you want the device to do when the condition is met. You can send internal or external URLs, which means you can send URLs to this device, or to another device.

Make sure to press the Save action button if you’re editing or creating an action.

Scripts

This device features scripting capabilities. You can use them to customize and enhance device functionality based on a user’s specific needs. These scripts can take into consideration device state, communicate with other devices, or pull data from external services like weather forecasts. A script is a program, written in a subset of JavaScript.

Settings

Network settings

  • Access Point - Configure the device's AP, including switching it on or off, and setting a password. The access point of the device is an open network by default. The SSID is unique and cannot be changed.

  • Wi-Fi - Register the Shelly device to connect to up to 2 different Wi-Fi networks.

    Either input or select the Wi-Fi network. Can select an open network, and also set a static IP address.

    Enable Wi-Fi 1, or Wi-Fi 2, or both at the same time. If both Wi-Fi 1 and Wi-Fi 2 are enabled, and the Shelly device disconnects from one of the networks, it will connect to the other.

  • Bluetooth - Disable/enable Bluetooth by toggling the switch. The device's default Bluetooth setting is enabled.

Connectivity

  • Cloud -Connecting your Shelly to its cloud allows you to control it remotely, and receive notifications and updates about your devices. The default for this setting is for the cloud to be enabled. If you disable the device cloud support, you will lose connection to your device from outside its local network!

  • MQTT - Configure the Shelly device to execute actions via MQTT. By default, MQTT is disabled, but you can enable it by toggling the switch. Changing these settings will cause the device to reboot. There are some other settings, such as RPC status notifications over MQTT (which enables you to communicate with your device through RPC notifications) and Generic status update over MQTT (to get an overall status update), which you can enable/disable by toggling the switches on their right. You can also enable SSL and type in your server, username, and password, but be aware that enabling SSL will hurt the battery life and most likely shorten it by half.

  • Outbound Websocket - Specifies whether the HTTP channel creates an I/O exception when an inbound connection is closed while still in use by the servlet. By default, this setting is disabled. To enable it, click the toggle switch next to Enable. Enter your service address in the text box and from the drop-down menu under SSL Connectivity choose *, ca.pem or user_ca.pem.

  • Range extender - Turning on the Range extender feature creates a hotspot that you can connect Wi-Fi devices to. If a Shelly device with the range extender enabled is connected to a Wi-Fi router and the Internet, all devices connected to it are also connected to the router and the Internet.
    Even if the Shelly device is not connected to a Wi-Fi router, all devices connected to it can still communicate with it and with each other.

  • RPC over UDP - Communicate with your device and send requests through a Remote Procedure Call (RPC) over a User Datagram Protocol (UDP) server. This can be useful in controlling and monitoring your device remotely, without the need for a dedicated server or connection.

    To use this setting, you'll need to enter the listen port and destination address for the UDP server. The listen port is the port number that the device will listen on for incoming requests, while the destination address is the IP address of the server to which the requests will be sent.

    Once you've entered the required information, you can use the RPC over UDP protocol to send requests to your device and receive responses.

Device settings

  • Device name (info) - See your device’s ID, the Wi-Fi it’s connected to, and the Wi-Fi RSSI.

  • Reboot - After clicking on the Reboot button, you will be asked if you’re sure you want to reboot your device. Click OK for device reboot and Cancel if you don’t want the device to reboot.

  • Factory reset - By clicking on the Reset button, your device’s settings will all be reset to the default. Any changes you’ve made will be reverted. You can confirm that you want the device to factory reset by clicking OK on the pop-up, or Cancel to cancel the factory reset.

  • Location and timezone - Your timezone and location will be autodetected, but you can manually change them from this setting by choosing a timezone from the drop-down menu and typing in your latitude and longitude. There is also a button Auto detect location, which will make the device automatically detect the location once again if it failed the previous time.

  • Authentication - If you enable authentication, you will be asked to type in a password, which you will then use to access the Web UI of the device. Once enabled, to disable it, click the toggle and enter your authentication pass once prompted.

  • Firmware - In this setting, you can see your device's ID, Firmware version, and build ID, as well as the Web build ID. You can also see the available new versions, check for updates and easily update your device. There is also an option to upload your own firmware, however flashing devices with custom firmware irreversibly voids the device warranty.

  • User certificate (TLS Configuration) - Upload custom certificate authority, client certificate, and client key by dragging and dropping the file(s), or by browsing your files, which you can do by clicking the designated button. Click Upload to upload the files, and Clear to remove files you don’t want to upload.

  • Eco mode - Reduce energy consumption on the device by lowering CPU frequency and modem activity while in Eco Mode. To enable this setting click the toggle switch next to Enable eco mode and then click the Apply button to save the changes.

  • Debug - This setting includes Mqtt, Websocket, and Udp debug. To enable any of these, click the toggle switch next to the specific setting. For Udp debug you will also be asked to type in a Udp address.

  • Units - Choose the units the measured data will be displayed in.

Advanced Settings

Upon clicking on the arrow next to this setting, you will reveal the advanced settings. They are explained below.

KVS

KVS stands for Key-Value Storage and is a type of non-relational database, which works by using a simple key-value method to store data. In one device, you can store up to 50 key-value pairs. Upon clicking on the Add value button, you will be taken to the value creation screen, which prompts you to enter a key (up to 42 characters), and value (up to 253 characters). You’ll notice under the text box for the value is the current value type. By default, the value type is Number, but by entering text, the type will change to String. To save the key, simply click the Save button. To edit an existing value, simply click on it. To delete a key-value pair, click the Delete button that appears below it when you go to edit the key. Clicking on the question mark next to the setting name will take you to the API documentation, which will provide you with further information on how the KVS works for Shelly devices.

Diagnostics

From this setting, you can download the debug logs. Enabling the debug log without a reason isn’t recommended, since your device will be slowed down and this setting will cause aging of the flash memory. If you do decide to enable it, you can also download the previous and current logs. Be aware that leaving this page will reset the logger and log data.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.