IKEA Tradfri Shortcut Button - DeCONZ Setup Guide

Tags: #<Tag:0x00007fc4014099e0> #<Tag:0x00007fc401409918>

About the device & my reasons for wanting one
I recently purchased one of the reasonably new IKEA Tradfri Shortcut buttons and after looking around online (and on this site) I couldn’t find a complete setup guide for DeCONZ so I thought I’d write one!

For those of you who don’t know what I’m talking about here is a link to the UK IKEA site – Basically though, they’re a simple ZigBee button. I’ve seen them compared to the Tradfri Dimmer and in terms of height and width they are exactly the same (they use the same wall mount) but it’s not as pronounced and only has the one button! What they do come with, which I thought was pretty cool, are 6 stickers that can sit under a plastic cover on the front of the switch. The three stickers included with mine were a pendant light, a tea mug, a bed and three blank stickers (two of which are covered in tiny dots).

For me, this Shortcut button is perfect as I have a Shelly 1 hooked up to the lights in my kitchen to allow for two switches in the room without any extra wiring! The lights aren’t dimmable, so I only need a single button to toggle the current state. Originally, I had a Tradfri dimmer and I just had this set up so that no matter if you pressed the on or off button it’d toggle the current light state - This worked but wasn’t user friendly.

The Guide
Enough about the device and my usage of it though, on to setup…

  • Take the button out of the box & unscrew the back (you’ll need a very small Phillips screwdriver!)
  • Insert the battery but make sure to leave the cover off
  • Take the button to where it’ll live (this is so that the button attaches to the correct ZigBee router first time)
  • Open up Phoscon and go to Devices, Switches and then “Add New Switch”
  • You have to select “Other” from the provided list as the button isn’t listed under IKEA. Phoscon will now search for new switches for three minutes…
  • Press the link button on the device 4 times (the link button is the one that has an icon of two chain links, it’s next to the battery) – If you’ve done this right then a red LED will flash/pulsate that can be seen from both the back and front of the device.
  • I personally then pressed the button a few times – This is only due to past experience with some Xiaomi Aqara devices where the device needs to ‘send data’ in order to pair. I have no idea if this is necessary for this button!
  • At this point, Phoscon will not give you a success screen like you may get when adding bulbs etc. In fact it’ll time out and say “Failed to connect”, however, if you open DeCONZ you should see the device on your spaghetti map.


If it’s there then it’ll also now be in Home Assistant. Mine showed up as “TRADFRI SHORTCUT Button”. I didn’t get the battery level showing straight away in Home Assistant but it eventually showed up (YMMV).

So the button is now connected to DeCONZ and Home Assistant. However, at the time of writing, you cannot easily utilise the button in automations and instead have to set up templates based on DeCONZ events! Luckily though, there are a number of Blueprints that have been created by the community – I used this one.

Let me know if you have any questions - I’ll add some more pictures to this guide in the next couple of days too :+1: