# How do I use uiQuickAction?

**URL:** <https://community.homey.app/t/how-do-i-use-uiquickaction/112549>\
**Category:** Developers\
**Tags:** app, supportrequest\
**Created:** [July 7, 2024, 9:16pm UTC](https://community.homey.app/t/how-do-i-use-uiquickaction/112549 "2024-07-07T21:16:10Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![johnnyDrama](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/johnnydrama/32/80488_2.png) [@johnnyDrama](https://community.homey.app/u/johnnyDrama)\
**Post date:** [July 7, 2024, 9:16pm UTC](https://community.homey.app/t/how-do-i-use-uiquickaction/112549/1 "2024-07-07T21:16:10Z")

</div>

Hi,

I’m trying to develop my first Homey app. I have manged to add an alarm that goes off at a certain event. I’d like the user to be able to reset the alarm. The alarm is currently added as such:

```auto
{
    "type": "boolean",
    "title": { "en": "Filter change needed" },
    "getable": true,
    "setable": true,
    "uiComponent": "sensor",
    "uiQuickAction": "true",
    "icon": "/assets/icon.svg",
    "insights": true,
    "insightsTitleTrue": { "en": "Filter change needed" },
    "insightsTitleFalse": { "en": "Filter OK" }
  }

```

I have managed to find the capability uiQuickAction ([Capabilities | Homey Apps SDK](https://apps.developer.homey.app/the-basics/devices/capabilities)), but I can’t seem to find any documentation on how to use it? I.e. where is the user supposed to click to activate it? And where do I put the code to be executed on that quick action?

Thanks to anyone that cares to help a beginner…

---

<div class="post-metadata">

**Author:** ![Adrian\_Rockall](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/adrian_rockall/32/13209_2.png) [@Adrian\_Rockall](https://community.homey.app/u/Adrian_Rockall)\
**Post date:** [July 8, 2024, 7:31am UTC](https://community.homey.app/t/how-do-i-use-uiquickaction/112549/2 "2024-07-08T07:31:17Z")

</div>

I believe the quick action can only be used with a toggle. A sensor can only be changed by code.  
Maybe add a button that resets the alarm.

When the quick action is applied, it means the user can tap on the tile in the devices list to toggle the capability, hence only applying to buttons.

---

<div class="post-metadata">

**Author:** ![johnnyDrama](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/johnnydrama/32/80488_2.png) [@johnnyDrama](https://community.homey.app/u/johnnyDrama)\
**Post date:** [July 8, 2024, 9:00am UTC](https://community.homey.app/t/how-do-i-use-uiquickaction/112549/3 "2024-07-08T09:00:48Z")

</div>

Thanks!

So as a newbie with Homey SDK (and programming in general) I just don’t understand how you know these things? Is there documentation that I didn’t find yet?

---

<div class="post-metadata">

**Author:** ![Jero](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jero/32/17556_2.png) [@Jero](https://community.homey.app/u/Jero)\
**Post date:** [July 22, 2024, 10:58am UTC](https://community.homey.app/t/how-do-i-use-uiquickaction/112549/4 "2024-07-22T10:58:08Z")

</div>

It seems you used **“true”** instead of **true** so it’s not a boolean but a string now.

---

<div class="post-metadata">

**Author:** ![johnnyDrama](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/johnnydrama/32/80488_2.png) [@johnnyDrama](https://community.homey.app/u/johnnyDrama)\
**Post date:** [August 29, 2024, 7:30pm UTC](https://community.homey.app/t/how-do-i-use-uiquickaction/112549/5 "2024-08-29T19:30:49Z")

</div>

thanks a lot, that solved it!