# Task component (legacy)

> The older Task component puts a button on a page that runs one task. New pages use the Workflow component, which runs a workflow instead.

Source: https://tadabase.com/docs/pages/task-component  
Status: Verified Nov 17, 2026. Checked against the current product

> **Tasks are the older system:** The Task component runs a task, and tasks are being replaced by workflows. For new pages, use the [Workflow component](https://tadabase.com/docs/pages/workflow-component) instead. This page is for apps that still use tasks.

The **Task** component puts a button on a page. When a user clicks it, the task you picked runs right away, either on the record the page shows or on the task's own records.

## Add it to a page

1. **Add the component** In the Page Builder, select the **Components** tab and drag **Task** from **Data Components** into the page. The **Add New Task** window opens.
2. **Choose the table** Under **Select the data table containing task**, choose the table. Only tables that have tasks are listed. On a page that shows one record, choose the option under **Records connected to this** record to run the task on that record only.
3. **Pick the task** On the **Data Source** tab, choose it in **Task**.
4. **Set the options and save** On the **Options** tab, set the fields below, then click **Update & Save**.

If no table has a task, the window says **There are no data tables with tasks added to this app yet.**

## Options

| Option | What it does | Default |
| --- | --- | --- |
| **Title** | Heading shown above the button. | Empty |
| **Description** | Text shown under the title. | Empty |
| **Task Button Text** | The button's label. | `Run Task` |
| **Success Message** | Message shown after the task starts. | `The task has been successfully run.` |

While the task starts, the button shows **Running...**.

## Replace it with a Workflow component

Rebuild the task as a workflow with a **Manual** trigger (to run on the page's record) or a **Schedule** trigger (to run on many records). Then add a [Workflow component](https://tadabase.com/docs/pages/workflow-component) that runs it and delete the Task component. The Workflow component also shows live progress and run history, which the Task component does not.
