Skip to content

Flow Actions

Arie J. Godschalk edited this page Nov 15, 2026 · 8 revisions

Flow cards: actions

Home · Triggers · Conditions

Actions are the Then part of a Flow. Each action operates on the type named on its card. Use the same name in related cards; the selected picker value takes precedence over a name entered in the text field.

Browse the Actions index for a dedicated page for every current action card.

Contents

Start and resume

Action What happens
Start or replace stopwatch, timer or transition Starts a new chronograph. An existing chronograph of the same type and name is replaced.
Resume stopwatch, Resume timer, or Resume transition Resumes a paused matching chronograph; leaves a running one running. Reports an error if none exists.
Start or resume stopwatch, timer or transition Starts it if absent, resumes it if paused, and leaves it running if already running.

Stopwatch start actions need only a name. Timer start actions need a duration and unit. Transition start actions need a duration and unit, start value, end value and a step count of at least two. The app limits the effective step count for short durations. See transition steps for an example that applies the values to a device.

Example — restart a countdown: When motion is detected, use Start or replace timer for Hall light with a duration of 5 minutes. A separate finished-trigger Flow turns off the light. Each new detection replaces the countdown.

Example — continue instead: Use Start or resume timer when you want a paused timer to continue from where it was, rather than restart. Its duration is used when a new timer is created, not to reset an existing timer. The supplied parameters must still be valid even when resuming an existing timer or transition.

Example — measure a workout: Start a stopwatch named Workout when the activity begins. Use Get the elapsed duration of a stopwatch before stopping it to include its elapsed time in a notification. You can also save a Stopwatch reached a duration Flow before starting it to give a reminder.

Pause, adjust and stop

Action What happens
Pause Pauses a running stopwatch, timer or transition.
Adjust Adds the specified amount to elapsed time; a negative amount subtracts it. Elapsed time cannot go below zero.
Stop Removes the named stopwatch, timer or transition.
Stop all Stops all chronographs of that type.

Pause, adjust, stop and resume-existing support wildcard names in the name field. Check the card's hint for details. A named operation can report an error when the chronograph does not exist.

Adjust changes elapsed time, not the target duration. For a timer, adding 2 minutes to elapsed time makes it finish 2 minutes sooner; subtracting 2 minutes gives it up to 2 extra minutes, subject to the zero-elapsed limit. For a stopwatch or transition, a positive adjustment moves the elapsed reading forward and a negative one moves it backward.

Example — give a timer more time: Adjust Oven by -2 minutes. If at least 2 minutes have elapsed, its remaining time increases by 2 minutes.

Get duration

Each type has a Get the duration action. It returns Flow tokens for the named existing chronograph:

  • Stopwatches expose elapsed duration.
  • Timers expose remaining and elapsed durations.
  • Transitions expose remaining and elapsed durations.
  • Values include milliseconds, converted seconds/minutes/hours and formatted time strings. The General settings tab controls the decimal places used for converted Flow-card values.

Use the action's output tokens in later steps, for example to send a notification showing how long a stopwatch has been running. The card reports an error if the requested chronograph does not exist.

Expressions

The current start, start-or-resume and adjust duration fields accept numeric expressions and Flow tokens. See MathJS expressions in Flow cards. Some Flow fields are also marked BLL supported; see BLL coding for syntax and examples.

Clone this wiki locally