Run a workflow from a button on a page

Use the Manual trigger and a Trigger Workflow button so users run a workflow on a record when they click, with optional messages while it runs.

  • Verified Nov 17, 2026
  • Classic builder

On this page
  1. 1. Create a Manual workflow
  2. 2. Add a Trigger Workflow button
  3. What the user sees while it runs
  4. Workflow and Workflow Manager components
  5. Tips

A workflow with the Manual trigger runs only when something starts it: a button in your app, or the API. Pair it with a Trigger Workflow button on a table, list or details component, and users can run it on a record when they choose: resend an invoice, approve a request, recalculate totals.

1. Create a Manual workflow #

  1. Choose the trigger Create a workflow, click the Trigger card and choose Manual in the People group.
  2. Pick the table Under Data Source, choose the table the button's records come from, for example Jobs. The record the user clicks becomes the run's Source Record.
  3. Add steps and switch it on Add your steps, switch the workflow to Active and click Save. Only active Manual workflows on the same table can be chosen for a button.

2. Add a Trigger Workflow button #

In a Table component:

  1. Open the component Open the page in the Page Builder, hover the table and click its edit icon.
  2. Add the action On the Columns tab, open the Actions list and click Trigger Workflow. It is greyed out until the table has at least one active Manual workflow.
  3. Choose the workflow In the new column's settings, choose the workflow under Select Workflow. Click the refresh icon next to it if a workflow you just created is missing.
  4. Save the page Save the component and the page.
A table component's Columns tab with the Actions list open and Trigger Workflow highlighted

List, Details and Kanban components have the same Trigger Workflow action in their actions list. In the newer universal components, add a Trigger Workflow button and set it up under Workflow Run Settings › Select Workflow.

What the user sees while it runs #

By default, the page waits while the workflow runs, and the user sees its messages. You control those messages in two places:

  • The trigger's Notification tab: the title and description shown When Workflow is in Queue, When Workflow Starts, When Workflow Ends and When Workflow Ends With Errors.
  • A Show Message step: a toast, banner or pop-up at any point in the workflow. See Utility actions.

In the universal components, Workflow Run Settings has two more switches:

  • Run Behind the Scenes: the workflow runs in the background so the user can keep working.
  • Show Progress Notifications (when Run Behind the Scenes is on): turn it off to run the workflow silently.

Every component button also has Show Loading Indicator, which shows the full-page loading indicator while the button is working.

Workflow and Workflow Manager components #

Two page components work with workflows too: the Workflow component, and the Workflow Manager component. See Workflow component and Workflow Manager component.

Tips #

  • Give the button a clear label, such as "Resend invoice" rather than "Run".
  • For anything that changes many records or sends emails, add a condition as the first step so the workflow checks the record before it acts.
  • Test on a real page as a real user: a workflow started by a button runs with that user logged in, so steps that use the logged-in user see them.

Was this page helpful?

Something wrong or missing on this page? Tell us.