# Workflows

> Part of the NocoDB documentation (Workflows). 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
Last updated: 2026-10-03

Use workflows in NocoDB to automate tasks that start from events or conditions in your base.

Use **Workflows** in NocoDB to automate tasks. A workflow responds to events or conditions in your base. It starts with a trigger and runs a sequence of actions. Optionally, flow logic such as conditions or iteration controls the actions.

<img alt="Example flow" src={__img0} placeholder="blur" />

Your plan sets a limit on workflow runs. Refer to Pricing for details.

NocoDB counts one workflow run each time a workflow is triggered. The number of actions in the run has no effect. For conditional triggers, NocoDB counts a run only when the conditions are true and the workflow runs.

Some nodes are available only on some plans. For plan details, refer to the page of each node.

***

<AskNocoAI>
  <Prompt>
    When a record is added to [table], send an email to [address]
  </Prompt>

  <Prompt>
    When [Status] changes to [Done], set [Completed On] to today
  </Prompt>

  <Prompt>
    Every [Monday], email me a list of [overdue tasks]
  </Prompt>

  <Prompt>
    Which workflows does this base have, and what does each one do?
  </Prompt>
</AskNocoAI>

## Workflow structure

A Workflow has these building blocks:

| Component                                                        | Purpose                                                           |
| ---------------------------------------------------------------- | ----------------------------------------------------------------- |
| **[Trigger node](/docs/workflows/nodes/trigger-nodes)**          | Defines **when** the workflow starts                              |
| **[Action nodes](/docs/workflows/nodes/action-nodes)**           | Defines **what** the workflow does                                |
| **[Flow nodes](/docs/workflows/nodes/flow-nodes)**               | Defines **how** actions are executed (logic, iteration or delays) |
| **[Integration nodes](/docs/workflows/nodes/integration-nodes)** | Action nodes. Connects to external services or AI capabilities    |

## Trigger nodes

A **Trigger** defines the event that starts a workflow. Each workflow must have exactly one trigger.

| Trigger                                                                                       | Description                                                            |
| --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| **[Manual trigger](/docs/workflows/nodes/trigger-nodes/manual)**                              | Runs only when started by a user                                       |
| **[Button clicked](/docs/workflows/nodes/trigger-nodes/button-clicked)**                      | Runs when a user clicks a Run automation button on an interface record |
| **[Scheduled time](/docs/workflows/nodes/trigger-nodes/scheduled)**                           | Runs on a defined schedule                                             |
| **[Record created](/docs/workflows/nodes/trigger-nodes/record-created)**                      | Runs when a new record is added                                        |
| **[Record updated](/docs/workflows/nodes/trigger-nodes/record-updated)**                      | Runs when an existing record changes                                   |
| **[Record deleted](/docs/workflows/nodes/trigger-nodes/record-deleted)**                      | Runs when a record is removed                                          |
| **[Form submitted](/docs/workflows/nodes/trigger-nodes/record-created-form)**                 | Runs when a specific form is submitted                                 |
| **[Record enters a view](/docs/workflows/nodes/trigger-nodes/record-enters-view)**            | Runs when a record appears in a view for the first time                |
| **[Record matches conditions](/docs/workflows/nodes/trigger-nodes/record-matches-condition)** | Runs when defined field conditions are met                             |
| **[Comment changes](/docs/workflows/nodes/trigger-nodes/comment)**                            | Runs when a comment is added, edited, deleted, resolved, or reopened   |

## Action nodes

Action nodes define the operations that run after the trigger fires. Actions run one after the other, in the order that they are connected.

| Action                                                                | Description                                    |
| --------------------------------------------------------------------- | ---------------------------------------------- |
| **[List records](/docs/workflows/nodes/action-nodes/list-records)**   | Retrieves multiple records based on filters    |
| **[Create record](/docs/workflows/nodes/action-nodes/create-record)** | Creates a new record in a table                |
| **[Update record](/docs/workflows/nodes/action-nodes/update-record)** | Updates fields in an existing record           |
| **[Delete record](/docs/workflows/nodes/action-nodes/delete-record)** | Removes a record from a table                  |
| **[Find record](/docs/workflows/nodes/action-nodes/find-record)**     | Retrieves a single matching record             |
| **[Send email](/docs/workflows/nodes/action-nodes/send-email)**       | Sends an email using configured email settings |

## Flow nodes

Flow nodes control the execution logic in a workflow. They do not do actions themselves. They control how actions run.

| Flow node                                                     | Description                                   |
| ------------------------------------------------------------- | --------------------------------------------- |
| **[If / else](/docs/workflows/nodes/flow-nodes/if-else)**     | Executes different paths based on a condition |
| **[Iterate](/docs/workflows/nodes/flow-nodes/iterate)**       | Repeats actions for each item in a list       |
| **[Delay](/docs/workflows/nodes/flow-nodes/delay)**           | Pauses execution for a specified time         |
| **[Wait until](/docs/workflows/nodes/flow-nodes/wait-until)** | Pauses until a condition is met               |

Flow nodes can use data from previous actions to control branching, iteration or delays.

## Execution order

A workflow always runs in this sequence:

1. The trigger fires.
2. Actions run from top to bottom.
3. Flow nodes apply branching or iteration.
4. All execution paths complete.
5. NocoDB records execution logs for auditing and debugging.

## FAQ(s)

### How can I monitor workflow runs?

Use the [execution logs](/docs/workflows/execution-logs) to monitor workflow runs. Each workflow has a run history. The run history shows the execution status, the duration and all errors. Your plan limits set how long NocoDB keeps execution logs.

### Can I edit a workflow after it is created?

Yes, you can edit workflows at any time. Changes apply only to future runs. Runs that are already in progress continue with the workflow version that was active when they started.
For workflows that are paused (for example, at **Delay** or **Wait Until** nodes), NocoDB asks you to select one of two options: continue with the current workflow definition, or update to the latest version.

### Are there limits on the number of workflows I can create?

There is no limit on the number of workflows that you can create. But your subscription plan can limit workflow runs, log retention and the availability of some node types. Refer to the [Pricing](https://nocodb.com/pricing) page for details.

### Can workflows interact with external services?

Yes. Workflows use [Integration nodes](/docs/workflows/nodes/integration-nodes) to connect to external services. With these nodes, workflows can send data to third-party APIs and get data from them. Future releases will add more integration nodes.

### How are workflow runs counted?

NocoDB counts one workflow run each time a workflow is triggered. The number of actions in the run has no effect. For conditional triggers, NocoDB counts a run only when the defined conditions are true and the workflow runs.

## Availability

* Workflows are available on NocoDB Cloud (all plans) and on self-hosted deployments. The Community Edition includes 2 workflows per base. These workflows can use the record and manual triggers, the record action nodes, and the If and Iterate flow nodes.

## Related

* [Pricing](https://nocodb.com/pricing)

---

## Related pages

- [Create Workflow](https://nocodb.com/docs/workflows/create-workflow.md): Create a workflow in a NocoDB base and configure its trigger, action and flow nodes.
- [Actions on Workflow](https://nocodb.com/docs/workflows/actions-on-workflow.md): Rename, duplicate, delete, enable and disable a workflow in NocoDB.
- [Workflow Folders](https://nocodb.com/docs/workflows/workflow-folders.md): Group workflows and scripts into folders in the Workflows sidebar, and read each workflow's status at a glance.
- [Nodes](https://nocodb.com/docs/workflows/nodes.md): Learn how nodes, the building blocks of NocoDB workflows, start workflows, run operations, control logic and pass data.
- [Execution Logs](https://nocodb.com/docs/workflows/execution-logs.md): Use execution logs in NocoDB to follow, stop, pause, resume and retry workflow runs.
- [Handling Failures](https://nocodb.com/docs/workflows/handling-failures.md): Retry failed workflow steps automatically in NocoDB, and find out what NocoDB does when a workflow run fails.
