# How a Flow Works

Source: https://userguide.qualytics.io/flows/flow/deep-dive/how-it-works/

This page explains the mechanics behind a Flow. It walks through the nodes that form its canvas, the settings the Flow node holds, the rules that limit how actions chain, and how an edit moves from saved to published.

## The Flow Canvas

Every Flow is drawn as a graph on a canvas, built from three kinds of nodes:

- **Flow node:** The root of the Flow. It holds the Flow's name, description, and activation state.
- **Trigger node:** Defines when the Flow starts. Each Flow has exactly one trigger, and it is always present on the canvas. See [Flow Triggers](https://userguide.qualytics.io/flows/flow/deep-dive/triggers/) for the six trigger types.
- **Action nodes:** Define what happens after the trigger activates. Actions run in order, from the trigger through each action node. See [Actions](https://userguide.qualytics.io/flows/flow/deep-dive/actions/) for the available action types.

For moving around the canvas, the zoom controls, and opening each node's settings panel, see [Navigate the Canvas](https://userguide.qualytics.io/flows/flow/how-tos/flow/navigate-the-canvas/).

## The Flow Node

The Flow node is the root of the graph and the Flow's identity. It exists from the moment the Flow is created, cannot be removed, and everything else on the canvas hangs from it. The name it carries is how the Flow appears on the canvas, on the Flows list, and in the messages its notifications send.

The **Deactivated** option on this node pauses the Flow. A paused Flow keeps its full configuration and ignores its trigger; it shows greyed out on the Flows list until you activate it again. See [Activate or Deactivate a Flow](https://userguide.qualytics.io/flows/flow/how-tos/flow/activate-or-deactivate-a-flow/).

Clicking the node opens the **Flow Settings** panel; each field is described in the [Create a Flow field reference](https://userguide.qualytics.io/flows/flow/how-tos/flow/create-a-flow/#fields).

## Chaining Rules

A few rules constrain how action nodes can be chained:

- The canvas accepts at most **10 Operation actions** per Flow (Sync, Profile, Scan, Export, Materialize).
- **Notification** and **Workflow** actions cannot have child actions. They end their branch, so place them last.
- **Ticketing** actions are only available after the **Anomaly Detected** and **Anomaly Status Changed** triggers.
- Actions that rely on an external service (for example Slack, ticketing systems, or n8n) require the corresponding [integration](https://userguide.qualytics.io/settings/integrations/overview/) to be connected before they can be selected.

## Saving, Publishing, and Unpublished Changes

Edits to a Flow follow a draft-then-publish model:

1. **Save** on a node's panel stores the edit as an unpublished change. The edited node shows a **CHANGED** badge next to its name, and the **You have unpublished changes** banner appears on the canvas.
2. **Publish** is what actually saves the Flow. It persists every unpublished change at once, makes them live, and clears the badges.
3. **Discard**, on the banner, drops the unpublished changes and restores the last published version of the Flow.
4. **View changes**, on the banner, or **Changes** in the canvas control bar, opens the **Unpublished changes** panel. It lists the settings, trigger, and actions that were added, removed, edited, or moved, with the old and new values. When the change touches the Flow's related datastores, it warns that publishing might change who can edit the Flow.

If you navigate away while changes are pending, the **Unpublished Changes** dialog warns that the changes will be lost if you leave the page.

> **Warning: Publishing is saving**
>
> **Save** on a panel only stores a draft on the canvas. Nothing is kept until you click **Publish**, so always publish the Flow after editing.

## Publish Validation

When you publish, the platform validates the whole Flow. If a node's setup is incomplete (for example a missing name or an unconfigured trigger), the publish fails, the failure dialog lists what is missing, and the affected nodes are marked with a red alert icon.

A notification whose message or subject names a variable the trigger does not provide, writes a variable with a missing brace pair or with spaces inside its braces, or has a malformed conditional is refused the same way, and one publish reports every refused action at once. The **Failed to publish** dialog shows one alert per action, titled with the channel, for example **Email notification has invalid settings**, summarized as **2 problems in the message and subject**, and listing each problem. On the canvas, the refused action's card carries a red  icon; open the action to see the same alert at the top of its settings panel. The mark is cleared by a **Test Notification** that gets past the check, whatever the channel then answers, and at the start of the next publish attempt. The refusal messages themselves are listed under [Validation](https://userguide.qualytics.io/flows/actions/deep-dive/message/#validation).

## While Executions Run

While a Flow has executions in progress, its canvas becomes read-only and a banner explains that the Flow cannot be managed until they finish. Abort the running executions or wait for them to complete before editing. See [Flow Executions](https://userguide.qualytics.io/flows/flow/deep-dive/executions/).

## See Also

- **Triggers**

  The six trigger types, schedule configuration, and the filter conditions each type supports.

  [Triggers](https://userguide.qualytics.io/flows/flow/deep-dive/triggers/)
- **Actions**

  The five action categories, the chaining rules between them, and where each is documented.

  [Actions](https://userguide.qualytics.io/flows/flow/deep-dive/actions/)
- **Executions**

  The Definitions and Executions tabs, execution states, and the read-only execution graph.

  [Executions](https://userguide.qualytics.io/flows/flow/deep-dive/executions/)
- **Examples**

  Real scenarios showing how a trigger and a chain of actions combine into a working automation.

  [Examples](https://userguide.qualytics.io/flows/flow/deep-dive/examples/)
- **Best Practices**

  Guidelines for building Flows that stay quiet when healthy and loud when something breaks.

  [Best Practices](https://userguide.qualytics.io/flows/flow/deep-dive/best-practices/)
- **Permissions**

  The user roles behind viewing, building, executing, and deleting Flows.

  [Permissions](https://userguide.qualytics.io/flows/flow/deep-dive/permissions/)

*Last updated: October 28, 2026.*
