Waiting, time limits and reminders
Which journey steps wait, how their time limits and reminders work, what happens at the limit, and the clinic defaults that apply.
Many journey steps wait: for a time, for an event, for a staff member, for a patient's answer or for a signature. This page explains how waiting works across all of them, how to set time limits and reminders, and what the journey does when time runs out. It is for the administrators and implementation staff who build journeys.
Why time limits matter
A step that waits for a person can wait for ever if nobody acts. A time limit guarantees the journey moves on. When the limit passes, the step finishes with a fixed outcome (for example Nobody answered in time on an Engage step). You then decide on the canvas what happens next by connecting that outcome to another step: a task for someone else, a reminder message, or a Close step.
Connect the path taken at the limit
If nothing on the canvas handles the time-limit outcome, and the step has no default connection, the patient's track ends at that step with no outcome. Always connect the limit path, or give the step a default connection. See The builder canvas and how connections work.
Steps that wait, at a glance
Step | What it waits for | Time limit counted from | Path at the limit |
|---|---|---|---|
Pause | A time, one or more events, or both. The first to happen wins. | The anchor you choose (see below) | The branch that woke it (Time branch or Event n) |
Gather | The incoming tracks, per its Policy | The first arrival | timeout (also used for impossible when nothing handles that) |
Engage, when set to Wait here | A staff member to finish the task and give an answer | The moment the task is raised | Nobody answered in time (the outcome fallback) |
Capture, when set to Wait here | The answers to the forms listed on the step. The first decisive answer wins. | The moment the step starts, or the time in Count from (optional) | The path you name in Path taken at the limit |
Sign, when set to Wait here | Every signer to sign | Your choice in Time limit counted from | Expired unsigned (the outcome expired) |
Produce (always waits) | The AI flow to produce the document | The moment the flow starts | Timed out (the outcome timed_out) |
Reach, Appointment, Connect, Involve and Tell do not wait. Routine has its own schedule and outcomes: see Routine node.
The Waiting section on a step
Engage, Capture, Sign and Produce share a Waiting section in their settings. It has the same fields everywhere, though some are fixed on some steps.
Field | What it does |
|---|---|
Waits for | A plain description of what the step waits for. You cannot change it. |
Wait here or move on | Wait here holds the patient at this step until it finishes or the limit passes. Move on at once continues the journey straight away: "The journey goes on at once. Nothing is waited for on this step." Produce always waits. |
Time limit | An Amount and a Unit (minutes, hours or days). Required when the step waits, except on Sign: "A step that waits needs a time limit. Without one it could wait for ever." Produce uses Time limit (seconds). |
Time limit counted from | Sign only: The moment the step starts, The moment the link goes out, or Clinic default. |
Reminder before the limit | How long before the limit to send a reminder. It must be shorter than the limit: "The reminder must come before the time limit." Leave it empty to use the clinic default. |
At the limit | The path the journey takes when time runs out. Fixed on Engage, Sign and Produce. On Capture you type it in Path taken at the limit. |
Open work when the journey moves on | What happens to a task of this step that is still open when the journey moves past it. See "Open tasks when a step moves on" below. |
On the canvas, the step's card summarises its waiting: Moves on at once, Waits, no time limit set, or Waits up to 2 days, then takes fallback.
If a limit was saved in seconds that do not make whole minutes, the field shows Saved as N seconds. Enter an amount to replace it.
Engage
Wait here makes the task blocking: the journey waits for the staff member's answer. The answers they can give are listed under Answers staff can give, and each one becomes an outcome you can route on. At the limit the step takes Nobody answered in time.
The reminder notifies the assignee or role about the task again, on top of the task escalation policies set on the Organisation tab of SettingsPlatform ConfigurationSystem Settings. When the step is run by a recurring schedule it cannot wait: "A step run by a scheduler never waits."
See Engage node.
Capture
Wait here awaits the forms listed on the step and routes on the answers. Move on at once lets you choose What this step does: Send the form now or Only watch for a form sent elsewhere.
You name the limit path yourself in Path taken at the limit. The same path is taken when an answer matches none of the answer routes. Leave Count from (optional) empty to count from the start of the step, or enter an expression for another moment to count from, such as a time an earlier step recorded.
The reminder sends a form that went to the patient again, or brings a form task up again for staff.
See Capture node.
Sign
Wait here holds the journey until everyone has signed. Move on at once continues as soon as the links are out: "The document keeps its time limit and follow-up; a Pause later can wait for the document signed from this step."
The time limit is optional on Sign. Without one, the clinic's default signing time applies: the card shows Waits for the clinic default time, then takes expired. Counting from The moment the link goes out moves the limit when a link is held back for quiet hours.
The reminder sends the link again to every signer who has it and has not signed. Separately, the follow-up time gives the signing coordinator a task for every signer who has not signed. The follow-up must be shorter than the time limit.
See Sign node.
Produce
Produce always waits for the AI flow, so the limit is required. No reminder is sent, and the step raises no tasks. At the limit the step takes Timed out.
See Produce node.
Reminders
A reminder fires at the time limit minus the reminder time. For example, a 48-hour limit with a 6-hour reminder sends the reminder 42 hours after the limit started counting.
- Engage: the task is notified again.
- Capture: a form sent to the patient is sent again, or a form task is brought up again.
- Sign: the signing link is sent again to every unsigned signer who has it.
If the reminder time is equal to or longer than the limit, no reminder is sent. Because a reminder resends the same form or signing link, the patient may receive it twice; this is expected.
Open tasks when a step moves on
A step can move on while its task is still open: its time limit passes, staff skip it, or an interrupt ends it. Open work when the journey moves on decides what happens to that task:
Choice | Effect |
|---|---|
Clinic default | Uses the setting in System Settings (see below). Out of the box this is Keep it open. |
Keep it open | The task stays on the worklist. |
Cancel it | The task is cancelled. |
Hand it to operations | The task moves, unassigned, to the operations role named in System Settings under Staff & signing (Escalate closed journeys' open tasks to). If no role is named there, the task stays as it is. |
On Sign, the signing request itself is always cancelled when the step ends; the choice applies to its signing tasks. Open tasks left when the whole journey ends follow the journey's close policy instead (see Schedulers and journey settings).
Clinic defaults
Clinic-wide defaults for waiting live in SettingsPlatform ConfigurationSystem Settings, on the Journeys tab, in the Waiting section. Under While a step waits ("Applies to every Engage, Capture and Sign step that sets nothing of its own"):
Setting | Values |
|---|---|
Remind before the limit | A number of hours. Blank means no reminder. |
Open task when the step moves on | Keep it open, Cancel it or Hand it to operations. Platform default keeps it open. |
Signing limit counted from | When a Sign step's limit starts counting. Platform default is the moment the step starts. |
A value set on the step always wins over the clinic default. For every journey setting, see Notification, reminder and journey settings reference.
Pause: waiting for a time or an event
A Pause holds the patient until a time, an event, or whichever comes first. It needs at least one: "Wait for an event, until a time, or both — at least one."
Time branch
Field | Choices |
|---|---|
Anchor | Now (when the pause starts), An appointment's time, A patient attribute, An upstream node field, or A date on the patient's record |
Offset direction | After anchor (+) or Before anchor (−) |
Amount and Unit | How far from the anchor |
Outcome | The outcome the Pause finishes with when the time branch wins |
Missing-anchor policy | Fall back to activation moment (the default) or Wait silently for events (skip time branch). Only applies when an anchor is set. |
For an appointment anchor, choose Which appointment and the Time field: Slot start, Slot end, Check-in time or Completed time. "Wait until 2 days before the appointment" is an anchor of the appointment's slot start, Before anchor (−), 2 days.
Waits follow changes to their anchor:
- A wait anchored on A date on the patient's record moves when that date changes: "Armed timers follow the record: when this date changes, the wait re-anchors."
- A wait anchored on an appointment re-reads the appointment when the time comes. If the appointment has moved later, the wait moves to the new time.
If the anchor is missing when the Pause starts (for example, the patient has no appointment yet), Fall back to activation moment counts from the moment the Pause started. Wait silently for events ignores the time branch and waits only for events. A Pause set to wait silently must have an event branch, or nothing can wake it.
Event branches
Select Add event branch to wait for an event from the Event catalog. Each branch has an Event type, an Outcome, and optionally an Only when… filter over the event's details and a From step to match only the event produced by a particular earlier step (for example, a task of that step being completed). A Pause cannot wait for its own journey's lifecycle events: "A journey cannot wait on its own lifecycle." Events from linked journeys are allowed.
Both branch types can add routes under Routing when the event arrives: the first route whose condition holds sets the outcome, otherwise the branch's Outcome is used.
On the canvas, use the Pause branch field on each connection leaving the Pause to say which branch it follows. See Pause node.
Gather: waiting for parallel tracks
A Gather waits for the tracks that lead into it. Its Timeout ("How long to wait for the other tracks, counted from the first arrival. When it runs out the timeout edge fires.") stops it waiting for ever. Without one the builder warns that the Gather "may wait forever". See Gather node.
When a step is already in the past
If a patient enters a journey late, some timed steps may fall in the past. For example, "remind 3 days before the appointment" when the appointment is tomorrow. The journey's Timing setting, If a step is already in the past when a patient enters, decides what happens:
Choice | Effect |
|---|---|
Skip it (default) | The timed wait is skipped. |
Move it to now | The wait starts again from now. A wait set after its anchor waits that long from now; a wait set before its anchor fires now. |
Run it anyway | The wait fires straight away, as if it were on time. |
A Pause that only has a time branch completes straight away along the time path when it is skipped. A Pause with event branches keeps waiting for its events.
Individual steps can override the journey setting under If this step is already in the past: Follow the journey (the card shows Follows the journey: and the current choice), Skip it, Move it to now or Run it anyway. This appears on Pause, Gather, Routine, Reach, Capture, Engage, Appointment, Connect, Produce and Sign.
Related pages
- The builder canvas and how connections work
- Schedulers and journey settings
- Where tasks come from and how they are assigned
- Node reference overview
Last updated on
The builder canvas and how connections work
Add and edit steps on the journey canvas, connect them, and understand exactly which connections fire when a step finishes.
Publishing and validation rules
How a journey is checked and published, what each finding level means, and the full list of review messages with how to fix each one.