Button clicked

The When a button is clicked trigger starts a workflow when someone clicks a Run automation button on an interface record. The clicked record is passed to the workflow, so you can build one-click actions such as "Send contract", "Escalate ticket", or "Generate invoice" that run against exactly the record the user is looking at.

Configuration

This trigger has no settings of its own. It is bound from the interface side:

1. In the interface builder, open a record on a Record detail page and go to Page › Record › User actions › Buttons.
2. Add a button and choose Run automation as its Action.
3. Under Automations, pick this workflow. Workflows that cannot be connected are greyed out; hover one to see why.

Alternatively, choose Create new automation from the same list. Give it a name and NocoDB creates a workflow with this trigger already bound; click Continue in Workflows to finish building it, or Finish later.

The trigger panel in the workflow editor shows which table, interface page, and button it is connected to, and warns when the button is not yet configured in the published version of the interface.

How it works

• A user clicks the Run automation button on a record. The button is available to users with the Editor role or above.
• The workflow starts once per click and shows an Automation started toast.
• The trigger outputs the clicked record (record.id and record.fields), plus the table, page, button, and the user who clicked.
• Each click counts as one workflow run against your plan's run limit.

Use cases

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