> For the complete documentation index, see [llms.txt](https://joe-page-software.gitbook.io/hubitat-dashboard/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://joe-page-software.gitbook.io/hubitat-dashboard/tiles/buttons.md).

# Buttons

Hubitat Button Devices

Hubitat Dashboard supports multiple buttons on a single device / tile and offers several ways to configure these.

By default, a single button device will show up like this:

<img src="https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FdUlUjGzcGIuFigBOiuEl%2Fimage.png?alt=media&amp;token=13617098-237b-4bf2-934f-84240d9a2c6d" alt="" data-size="original">

A device that has multiple buttons (4) would show up like this:

![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FOYw4D9mUXXV1wsXWlF12%2Fimage.png?alt=media\&token=759337ed-9620-4ed6-831a-b413aa8b69d3)

### Click Actions

* By default, clicking on a button will bring up a larger dialog. From there, you can send different commands to the Hub:

  1\) click will send 'press' command\
  2\) double-tap will send 'doubleTap' command\
  3\) press and hold will send the 'hold' command\
  ![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FKQufEMbOpihrzzDWk6aP%2Fimage.png?alt=media\&token=f2595dc7-3866-4cff-94a5-46e156cbfca9)
* You can change the click behavior by setting the device's '[click action](/hubitat-dashboard/features/click-action.md)' to be 'toggle' instead of 'prompt'. Then, clicking on the button on the main dashboard will send the 'press' command directly.
* long-pressing on the button tile will bring up the device details dialog. From here, you can click, double-tap or press and hold on the button to send these commands to the hub.\
  ![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FONP7NsNJNVyYhiJeY9BP%2Fimage.png?alt=media\&token=87cd6a89-73e9-440f-8954-557ed6ba40b3)

### Configure Buttons

If you have more than 1 physical button on your 'button' device, you can configure each of them individually to show text or an image.

* long-press on a button to open up the details screen and hit "Edit" to view the edit screen
* click on Manage Buttons to view all of the buttons for that device

![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2F0RKSN5UItbyLICqUtveo%2Fimage.png?alt=media\&token=ed9e65f9-d8bc-4d8f-8fcc-7234b380511c) ![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FGtMMK0jO3HFyY4f58dw2%2Fimage.png?alt=media\&token=b56ba579-1a8e-4a20-885d-76b1b4e3cc10)

* To show an image instead of a label, click on the little picture icon next to the button you want to change
* To change the button label, click on the large button with the current label (ie: "1")

![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FBzsd9hIgbbjrnvYsvHAo%2Fimage.png?alt=media\&token=632047bf-d458-4801-bfda-fb9576529098)

### Additional Notes

* Only 4 buttons will display on a single 1x1 tile. But, you can change the tile size to make up to 5 buttons visible on a tile if you change the size to be > 1 row tall

![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2F42RQYEwtXDyb6zrZ8xm2%2Fimage.png?alt=media\&token=3f10084e-2043-4b4d-a09e-0a1fc618db06) ![](https://359348802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk-IVGVr8G2SBHju4g7%2Fuploads%2FknknGLWdKgMn67TuSaWt%2Fimage.png?alt=media\&token=ae4472b9-6ba4-4c37-ba71-a2309acc941b)

* see this Youtube video for an example: <https://www.youtube.com/watch?v=iRlq5586LKY>