# 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.

Source: https://tadabase.com/docs/workflows/triggering-workflows-from-pages-and-buttons  
Status: Verified Nov 17, 2026. Checked against the current product

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.

> **Note:** **Trigger Workflow** buttons replaced the older Action Links that ran rules on a record. Existing ones keep working.

## 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](https://tadabase.com/docs-shots/workflows-trigger-workflow-button.webp)

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](https://tadabase.com/docs/workflows/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](https://tadabase.com/docs/pages/workflow-component) and [Workflow Manager component](https://tadabase.com/docs/pages/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.
