Skip to main content
Actions are what a component does when an interaction fires (a tap, a change, an appear). An interaction holds an ordered list of actions. This page lists every action kind and its fields. Every action is a ComponentAction with a kind plus its own fields, and may carry an optional delay.

Scheduling: delay

Because each action schedules independently, [setVariable @0, setVariable @1000] walks a variable through two values one second apart.

Action kinds

Go to a specific node.

goNext

Go to the next screen (follows the default edge). No fields.

goBack

Go to the previous screen. No fields. Used by the Back Button chrome preset.

closeFlow

Dismiss the entire flow. No fields. Used by the Close Button chrome preset. The closeFlow action ends the flow with the completed outcome. A system dismissal (swipe-to-dismiss or programmatic) ends it with the dismissed outcome instead. See Results and outcomes.

setVariable

Apply an operation to a variable. The primary way to mutate state. Operations by variable type: For boolean operations, value is unused (the operation is self-contained). For list, value is the item to add/remove/toggle, or the new array for set.

assign

Set one or more variables from expressions. Each assignment runs an expression through the SDK’s evaluator. The expression subset is documented in Conditions and expressions. An expression that cannot be evaluated is skipped (the variable is left unchanged), never written as empty or zero.
assign exists in the schema and the SDK evaluates it, but the editor does not expose it as a pickable action. It is used internally to compile payload bindings (for example {{payload.height}} from a custom component output). For everyday state changes, use setVariable.

trackEvent

Emit a custom analytics event.

openUrl

Open a URL.

haptic

Trigger device haptic feedback.

triggerAnimation

Fire a reactive animation step on a target component.

triggerParticle

Fire a particle effect overlay. Extends the shared particle config. See Particle effects for details.

custom

A named custom action.
custom actions are defined in the flow JSON but there is no public iOS API to register a native handler for them today (the SDK’s registerCustomAction is internal). A custom action with no matching handler does nothing on device. To run your own native code in response to a component event, use a custom component and wire its output instead.

SDK support and editor preview

In the editor’s preview mode, only triggerAnimation, triggerParticle, and haptic fire; navigation and state changes run as preview-only and are never persisted. See Preview and live mirror.