
WiFi BUTTON SWITCH
USER GUIDE
1
2
3
LEGEND
1. Button
2. USB port
3. Reset button
The WiFi battery operated button switch, Shelly Button1 may send commands for control of other devices, over the Internet. You can place it anywhere, and
move it at any time. Shelly may work as a standalone
Device or as an accessory to another home automation controller.
Specication
Power supply(charger)*: 1A/5V DC
Complies with EU standards:
• RE Directive 2014/53/EU
• LVD 2014/35/EU
• EMC 2004/108/WE
• RoHS2 2011/65/UE
Working temperature: –20°C up to 40°C
Radio signal power: 1mW
Radio protocol: WiFi 802.11 b/g/n
Frequency: 2400 – 2500 MHz;
Operational range (depending on local construction):
• up to 30 m outdoors
• up to 15 m indoors
Dimensions (HxWxL): 45,5 x 45,5 x 17 mm
Electrical consumption: < 1 W
*Charger not included
Technical Information
• Control through WiFi from a mobile phone, PC,
automation system or any other Device supporting
HTTP and/or UDP protocol.
• Microprocessor management.
CAUTION! When the device is connected to a charger,
it is also constantly active and sends the command
immediately.
CAUTION! Do not allow children to play with the
button/switch of the Device. Keep the Devices for remote control of Shelly (mobile phones, tablets, PCs)
away from children.
Introduction to Shelly®
Shelly® is a family of innovative Devices, which allow
remote control of electric appliances through mobile
phone, PC or home automation system. Shelly® uses
WiFi to connect to the devices controlling it. They can
be in the same WiFi network or they can use remote
access (through the Internet). Shelly® may work
standalone, without being managed by a home automation controller, in the local WiFi network, as well
as through a cloud service, from everywhere the User
has Internet access.
Shelly® has an integrated web server, through which
the User may adjust, control and monitor the Device.
Shelly® has two WiFi modes - access Point (AP) and
Client mode (CM). To operate in Client Mode, a WiFi
router must be located within the range of the Device.
Shelly® devices can communicate directly with other
WiFi devices through HTTP protocol.
An API can be provided by the Manufacturer. Shelly®
devices may be available for monitor and control
even if the User is outside the range of the local WiFi
network, as long as the WiFi router is connected to
the Internet. The cloud function could be used, which
is activated through the web server of the Device or
through the settings in the Shelly Cloud mobile application.
The User can register and access Shelly Cloud, using
either Android or iOS mobile applications, or any internet browser and the web site:
https://my.Shelly.cloud/.
Installation Instructions
CAUTION! Danger of electrocution. Keep the device
away from moisture and any liquids! The device
should not be used in areas with high humidity.
CAUTION! Danger of electrocution. Even when the
Device is turned off, it is possible to have voltage
across its clamps. Every change in the connection
of the clamps has to be done after ensuring all local
power is powered off/disconnected.
CAUTION! Before using the device please read the
accompanying documentation carefully and completely. Failure to follow recommended procedures
could lead to malfunction, danger to your life or violation of the law. Allterco Robotics is not responsible
for any loss or damage in case of incorrect installation or operation of this Device.
CAUTION! Use the Device only with power grid and
appliances which comply with all applicable regulations. short circuit in the power grid or any appliance
connected to the Device may damage the Device.
RECOMMENDATION! Тhe Device may be connected
(wirelessly) to and may control electric circuits and
appliances. Proceed with caution! Irresponsible attitude could lead to malfunction, danger to your life or
violation of the law.
In order to add the device to your WiFi network, please
connect it to a charger rst. Upon connecting it to a
charger, the device will create a WiFi Access Point.
For more information about the Bridge, please visit:
http://shelly-api-docs.shelly.cloud/#shelly-family-overview or contact us at: developers@shelly.
cloud
You may choose if you want to use Shelly with the
Shelly Cloud mobile application and Shelly Cloud
service. You can also familiarize yourself with the instructions for Management and Control through the
embedded Web interface.
Control your home with your voice
All Shelly devices are compatible with Amazon Echo and
Google Home. Please see our step-by-step guide on:
https://shelly.cloud/compatibility/Alexa
https://shelly.cloud/compatibility/Assistant
MOBILE APPLICATION FOR
MANAGMENT OF SHELLY®
Shelly Cloud gives you opportunity to control and adjust all Shelly® Devices from anywhere in the world.
You only need an internet connection and our mobile
application, installed on your smartphone or tablet.
To install the application please visit Google Play
(Android - left screenshot) or App Store (iOS - right
screenshot) and install the Shelly Cloud app.
Registration
The rst time you load the Shelly Cloud mobile app,
you have to create an account which can manage all
your Shelly® devices.
Forgotten Password
In case you forget or lose your password, just enter
the e-mail address you have used in your registration.
You will then receive instructions to change your
password.
WARNING! Be careful when you type your e-mail address during the registration, as it will be used in case
you forget your password.
First steps
After registering, create your rst room (or rooms),
where you are going to add and use your Shelly devices.
Shelly Cloud gives you opportunity to create scenes
for automatic turning on or off of the Devices at predened hours or based on other parameters like temperature, humidity, light etc. (with available sensor in
Shelly Cloud). Shelly Cloud allows easy control and
monitoring using a mobile phone, tablet or PC.
Device Inclusion
To add a new Shelly device turn it on and follow the
steps for Device inclusion.
Step 1
After the installation of Shelly following the Instalation Instructions and the power is turned on, Shelly
will create its own WiFi Access Point (AP).
WARNING! In case the Device has not created its’
own AP Wi-Fi network with SSID like shellybut-
ton1-35FA58, please check if the Device is connected accordingly to the Installation Instructions. If you
still do not see an active Wi-Fi network with SSID like
shellybutton1-35FA58 or you want to add the Device
to another Wi-Fi network, reset the Device. You will
need to remove the back cover of the Device. The
reset button is below the battery. Carefully move the
battery and hold the reset button for 10 seconds.
Shelly should return to AP mode. If not, please repeat
or contact our customer support at support@Shelly.
cloud
Step 2
Choose “Add Device”.
In order to add more Devices later, use the app menu
at the top right corner of the main screen and click
“Add Device”. Type the name (SSID) and password
for the WiFi network, to which you want to add the
Device.
Step 3
If using iOS: you will see the following screen:
Press the home button of your iPhone/iPad/iPod.
Open Settings > WiFi and connect to the WiFi network
created by Shelly, e.g. shellybutton1-35FA58.
If using Android: your phone/tablet will automatically
scan and include all new Shelly Devices in the WiFi
network that you are connected to.
Upon successful Device Inclusion to the WiFi network
you will see the following pop-up:
Step 4:
Approximately 30 seconds after discovery of any new
Devices оn the local WiFi network, а list will be displayed by default in the “Discovered Devices” room.
Step 5:
Enter Discovered Devices and choose the Device you
want to include in your account.

Step 6:
Enter a name for the Device (in the Device Name
eld). Choose a Room, in which the Device has to be
positioned. You can choose an icon or add a picture
to make it easier to recognize. Press “Save Device”.
Step 7:
To enable connection to the Shelly Cloud service for
remote control and monitoring of the Device, press
“YES” on the following pop-up.
Shelly Device Settings
After your Shelly device is included in the app, you
can control it, change its settings and automate the
way it works. To enter at the details menu of the respective Device, simply click on it’s name. From the
details menu you may control the Device, as well as
edit its appearance and settings.
Internet/Security
WiFi Mode - Client: Allows the device to connect to
an available WiFi network. After typing the details in
the respective elds, press Connect.
WiFi Client Backup: Allows the device to connect to
an available WiFi network, as a secondary (backup),
if your primary WiFi network becomes unavailable.
After typing the details in the respective elds, press
Set.
WiFi Mode - Acess Point: Congure Shelly to create
a Wi-Fi Access point. After typing the details in the
respective elds, press Create Access Point.
Cloud: Enable or Disable connection to the Cloud
service.
Restrict Login: Restrict the web interface of Shely
with a Username and Password. After typing the
details in the respective elds, press Restrict Shelly.
Actions
Shelly Button1 may send commands for control of
other Shelly devices, by using a set of URL endpoints.
All URL actions can be found at: https://shelly-api-
docs.shelly.cloud/
• Button Short Press: To send a command to an URL,
when the button is pressed once.
• Button Long Press: To send a command to an URL,
when the button is pressed and hold.
• Button 2x Short Press: To send a command to an
URL, when the button is pressed two times.
• Button 3x Short Press: To send a command to an
URL, when the button is pressed three times.
Settings
Longpush Duration
• Max - the maximum time, that the button is pressed
and hold, in order to triger Longpush command.
Range for max (in ms): 800-2000
Multipush
The maximum time, between pushes, when triggering
a multipush action. Range: 200-2000
Firmware Update
Update the rmware of Shelly, when a new version
is released.
Time Zone and Geo-location
Enable or Disable the automatic detection of Time
Zone and Geo-location.
Factory Reset
Return Shelly to its factory default settings.
Device Reboot
Reboots the Device
Device Information
• Device ID - Unique ID of Shelly
• Device IP - The IP of Shelly in your Wi-Fi network
Edit Device
• Device Name
• Device Room
• Device Picture
When you are done, press Save Device.
The Embedded Web Interface
Еven without the mobile app, Shelly can be set and
controlled through a browser and WiFi connection of
a mobile phone, tablet or PC.
Abbreviations Used:
• Shelly-ID – the unique name of the Device. It con-
sists of 6 or more characters. It may include numbers
and letters, for example 35FA58.
• SSID – the name of the WiFi network, created by
the Device, for example shellybutton1-35FA58.
• Access Point (AP) – the mode in which the Device
creates its own WiFi connection point with the respective name (SSID).
• Client Mode (CM) – the mode in which the Device
is connected to another WiFi network.
Installation/Initial inclusion
Step 1
Install Shelly to the power grid following the schemes
described above and place it into the console. After
turning the power on Shelly will create its own WiFi
network (AP).
WARNING! In case the Device has not created its’ own
AP WiFi network with SSID like shellyix3-35FA58,
please check if the Device is connected accordingly to the Instalation Instructions. If you still do not
see an active WiFi network with SSID like shelly-
ix3-35FA58 or you want to add the Device to another
Wi-Fi network, reset the Device. You will need to have
physicall access to the Device. Press and hold the reset button, for 10 seconds. After 5 seconds, the LED
should start blinking fast, after 10 seconds it should
blink faster. Release the button. Shelly should return
to AP mode. If not, please repeat or contact our customer support at: support@Shelly.cloud
Step 2
When Shelly has created an own WiFi network
(own AP), with name (SSID) such as shellybut-
ton1-35FA58. Connect to it with your phone, tablet
or PC.
Step 3
Type 192.168.33.1 into the address eld of your
browser to load the web interface of Shelly.
General - Home Page
This is the home page of the embedded web interface. Here you will see information about:
• Battery percentage
• Connection to Cloud
• Present time
• Settings
Internet/Security
WiFi Mode - Client: Allows the device to connect to
an available WiFi network. After typing the details in
the respective elds, press Connect.
WiFi Client Backup: Allows the device to connect to
an available WiFi network, as a secondary (backup),
if your primary WiFi network becomes unavailable.
After typing the details in the respective elds, press
Set.
WiFi Mode - Acess Point: Congure Shelly to create
a Wi-Fi Access point. After typing the details in the
respective elds, press Create Access Point.
Cloud: Enable or Disable connection to the Cloud
service.
Restrict Login: Restrict the web interface of Shely
with a Username and Password. After typing the
details in the respective elds, press Restrict Shelly.
SNTP Server: You can change the default SNTP server. Enter the address, and click Save.
Advanced - Developer Settings: Here you can change
the action execution via CoAP (CoIOT) or via MQTT.
WARNING! In case the Device has not created its’
own AP Wi-Fi network with SSID like shellybut-
ton1-35FA58, please check if the Device is connected accordingly to the Installation Instructions. If you
still do not see an active Wi-Fi network with SSID like
shellybutton1-35FA58 or you want to add the Device
to another Wi-Fi network, reset the Device. You will
need to remove the back cover of the Device. The
reset button is below the battery. Carefully move the
battery and hold the reset button for 10 seconds.
Shelly should return to AP mode. If not, please repeat
or contact our customer support at support@Shelly.
cloud
Settings
Longpush Duration
• Max - the maximum time, that the button is pressed
and hold, in order to triger Longpush command.
Range for max (in ms): 800-2000.
Multipush
The maximum time (in ms), between pushes, when
triggering a multipush action. Range: 200-2000.
Firmware Update
Update the rmware of Shelly, when a new version
is released.
Time Zone and Geo-location
Enable or Disable the automatic detection of Time
Zone and Geo-location.
Factory Reset
Return Shelly to its factory default settings.
Device Reboot
Reboots the Device.
Device Information
• Device ID - Unique ID of Shelly
• Device IP - The IP of Shelly in your Wi-Fi network
Actions
Shelly Button1 may send commands for control of
other Shelly devices, by using a set of URL endpoints.
All URL actions can be found at: https://shelly-api-
docs.shelly.cloud/
• Button Short Press: To send a command to an URL,
when the button is pressed once.
• Button Long Press: To send a command to an URL,
when the button is pressed and hold.
• Button 2x Short Press: To send a command to an
URL, when the button is pressed two time.
• Button 3x Short Press: To send a command to an
URL, when the button is pressed three times.
•
Additional Information
The device is battery powered, with a “wake” and
“sleep” mode.
The majority of the time Shelly Button will be in
“sleep” mode when on battery power, to provide a longer battery life. When you press the button, it “wakes
up”, sends the command you need and it goes in
“sleep” mode, to preserve power.
When the device is constantly connected to a charger, it sends the command immediately.
• When on battery power - the average latency is
around 2 seconds.
• When on USB power - the device is always connect-
ed, and there is no latency.
The reaction times of the device are dependent on
internet connection and signal strength.
You can see the latest version of this User Guide in
.PDF by scanning the QR code or you can nd it in the
User manual section of our website: https://shelly.
cloud/support/user-manuals/
Allterco Robotics EOOD, Soa, 1407, 103 Cherni vrah Blvd.
+359 2 988 7435, support@shelly.cloud, www.shelly.cloud
The Declaration of Conformity is available at www.shelly.cloud/dec-
laration-of-conformity
Changes in the contact data are published by the Manufacturer at the
ofcial website of the Device www.shelly.cloud
The User is obliged to stay informed for any amendments of these
warranty terms before exercising his/her rights against the Manufacturer.
All rights to trademarks She® and Shelly® , and other intellectual
rights associated with this Device belong to Allterco Robotics EOOD.