# Button clicked

> Part of the NocoDB documentation (Workflows > Workflows > Nodes > Trigger). Index of all pages: https://nocodb.com/llms.txt. Any docs page is available as Markdown by adding `.md` to its URL.

URL: https://nocodb.com/docs/workflows/nodes/trigger-nodes/button-clicked
Last updated: 2026-10-03

Start a workflow when a user clicks a Run automation button on an interface page or record.

The **When a button is clicked** trigger starts a workflow when a user clicks a **Run automation** button in an interface. What the workflow gets depends on where the button is:

| Button location                                              | What the workflow gets                                                      | Example actions                                        |
| ------------------------------------------------------------ | --------------------------------------------------------------------------- | ------------------------------------------------------ |
| Record sheet, record pane, or field group                    | The clicked record. The workflow runs on the record that the user looks at. | "Send contract", "Escalate ticket", "Generate invoice" |
| Table page header, record review toolbar, or dashboard group | No record                                                                   | "Generate weekly report"                               |

<img alt="When a button is clicked trigger node" src={__img0} placeholder="blur" />

<AskNocoAI>
  <Prompt>
    Build a workflow that runs when someone clicks [a button] on a [Deals] record and [emails the customer]
  </Prompt>

  <Prompt>
    Build a workflow that runs from a button on [Orders] and [sets Status to Shipped]
  </Prompt>

  <Prompt>
    Build a workflow that runs from a button on [Candidates] and [creates an Interview record]
  </Prompt>
</AskNocoAI>

### Configuration

The When a button is clicked trigger has no settings of its own. You connect it to a button in the interface:

1. In the interface builder, open the button settings of the placement that you want:
   * On a record detail page, record pane, or field group: **Page › Record › User actions › Buttons**.
   * On a table page, record review list, or dashboard group: **User actions › Buttons**.
2. Add a button.
3. For its **Action**, select **Run automation**.
4. Under **Automations**, select this workflow. Workflows that you cannot connect are greyed out. Hover over one to see why.

You can also select **Create new automation** from the same list:

1. Give the automation a name. NocoDB creates a workflow with this trigger already connected to the button.
2. Click **Continue in Workflows** to finish the workflow now, or click **Finish later**.

The trigger panel in the workflow editor shows the connected table, interface page, and button. It shows a warning when the button is not yet configured in the published version of the interface.

<Callout type="note">
  A workflow can be bound to one button. The workflow must be enabled, and the interface published, before the button runs it.
</Callout>

### How it works

* A user clicks the **Run automation** button on a record or page. Users with the Editor role or above can use the button.
* The workflow starts once for each click. An **Automation started** toast shows.
* For record buttons, the trigger outputs the clicked record (`record.id` and `record.fields`). It also outputs the table, page, button, and the user who clicked.
* For page-level buttons, the trigger outputs only the page, button, user, and time.
* Each click counts as one workflow run against the run limit of your plan.

### Use cases

* Send a document or email for the record on demand
* Escalate a ticket or hand it off to another team
* Start a multi-step process, such as onboarding, from a single button

## Availability

* Available on NocoDB Cloud (all plans) and licensed on-premise deployments. The button itself is configured in [Interfaces](/docs/interfaces).

---

## Related pages

- [Manual](https://nocodb.com/docs/workflows/nodes/trigger-nodes/manual.md): The Manual Trigger node starts a NocoDB workflow only when a user runs it.
- [Scheduled](https://nocodb.com/docs/workflows/nodes/trigger-nodes/scheduled.md): The Scheduled Trigger runs a NocoDB workflow on a fixed schedule.
- [Record Created](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-created.md): Trigger workflows when new records are created in NocoDB.
- [Record Updated](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-updated.md): Trigger workflows when records are updated in NocoDB.
- [Record Deleted](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-deleted.md): Trigger workflows when records are deleted in NocoDB.
- [Record Matches Condition](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-matches-condition.md): Trigger workflows when records meet specific conditions in NocoDB.
- [Record Created via Specific Form](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-created-form.md): Trigger workflows when new records are created via a specific form in NocoDB.
- [Record Enters a View](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-enters-view.md): Trigger workflows when records enter a specific view in NocoDB.