---
title: "button · RUAL Documentation"
description: "Adds a button that can be placed anywhere in the row."
canonical: https://docs.rual.nl/block-types/state%20ui/statedatatableconnection_button
language: en
---

# button

This block is part of the [`state ui`](https://docs.rual.nl/block-types/state%20ui) group and was last modified in core [`v13.0.6`](https://docs.rual.nl/core-versions/130006).

### Function Selection Required

This block requires you to choose a custom function to execute when triggered. You must manually select the function you want to use using the function selector modal. To access the modal, click the white button on the block.

### Connection Type

This block connects from a `statedatatableconnection` type block. Make sure to connect this block to the appropriate left-hand side connection.

Adds a button that can be placed anywhere in the row.

- text required `value` To be shown within the button, you can use data from the result like `{{ name }}`

- icon `value` To be shown next to the next.

- class icon `v13.0.6` `uiclass` Hidden when unused

- style icon `v13.0.6` `uistyle` Hidden when unused

- attributes icon `v13.0.6` `uiattributes` Hidden when unused

- column title `v13.0.6` `value` Column title to be shown for the column • Hidden when unused

- class `uiclass` Hidden when unused

- style `uistyle` Hidden when unused

- attributes `uiattributes` Hidden when unused

- add before `fielddefinitions` Adds the button before the given column. • Hidden when other fields are filled

- add after `fielddefinitions` Adds the button after the given column. • Hidden when other fields are filled

- statedatatableconnection `statedatatableconnection`

A typical wiring for [button](https://docs.rual.nl/block-types/state%2520ui/statedatatableconnection_button): [value](https://docs.rual.nl/block-types/value/value_default) feeds the `text` pin; the `statedatatableconnection` out pin feeds [datatable](https://docs.rual.nl/block-types/state%2520ui/state_datatable).

![Studio canvas example for the button block: typical wiring for button.](https://docs.rual.nl/canvas-examples/statedatatableconnection_button.png)

### Version history

Introduced in [`v13.0.1`](https://docs.rual.nl/core-versions/130001).

Last modified in [`v13.0.6`](https://docs.rual.nl/core-versions/130006).

- [Back to `state ui`](https://docs.rual.nl/block-types/state%20ui): Return to the main group to view all sub-groups

- [Back to `datatable actions`](https://docs.rual.nl/block-types/state%20ui?group=datatable%20actions): Return to the group to view all blocks within this group