Pathway Workflows organize a participant’s process into clear steps, connect those steps to tasks, forms, and assessments, and help your team track what needs to happen next. Use sequential pathways when work needs to follow an order, or leave sequencing off when steps can happen independently.
Before you begin: Pathway Workflows must be enabled for your account. Your permissions determine which pathways, settings, and participant records you can manage. If the workflow options described here are missing, contact your administrator or Equip Support.
How it works
Build the reusable pathway in the pathway library, then add it to a participant’s record. Each participant has their own progress, assigned supporters, linked work, and step outcomes.
Choose a step type for each part of your process: Manual, Task, Form, or Assessment.
Add required or optional substeps beneath a Manual step when several pieces of work belong to the same stage.
Choose whether the pathway is Sequential and whether eligible steps should Auto Complete.
Include the appropriate steps for the participant, assign supporters, and follow progress from the participant’s pathway details.
Benefits
Give your team a consistent process without treating every participant’s progress as identical.
Connect required tasks and responses to the stage where they belong.
Keep later work from starting before earlier stages are resolved.
Distinguish successful completion from work that ended incomplete or was skipped.
Understand the four step types
Manual
Use a Manual step for a service, stage, or activity that a team member manages. Staff record its start and completion. A Manual step can contain Task, Form, or Assessment substeps. If it has required substeps, you can enable Auto Complete so the parent finishes when its required work is resolved; otherwise, staff complete the parent after that work is resolved.
Task
Use a Task step for an action that needs to be checked off. Equip creates a linked to-do when the work becomes available. Completing that to-do completes the step. Task steps do not have a separate Auto Complete setting.
Form
Use a Form step when a specific form response is part of the workflow. Select the required form when you configure the step. The response must be submitted, and if the form requires approval, it must also be approved. With Auto Complete on, the qualifying response completes the step. With it off, the step becomes Ready to complete and a team member finishes it manually.
Assessment
Use an Assessment step when a specific assessment needs to be completed. Select the required assessment when configuring the step. With Auto Complete on, a completed response completes the step. With it off, the completed response makes the step Ready to complete for a team member to finish.
Important: Complete the form or assessment through the work associated with this participant’s pathway step. An unrelated response, a response from a previous enrollment, or a response simply linked to the pathway does not automatically satisfy the step.
Set up a pathway workflow
Open Pathways → Library and open the pathway you want to configure.
Choose Edit Pathway. Turn on Sequential if the top-level steps must follow an order, then select Update Pathway. Leave Sequential off when steps can happen independently.
Select Add Step. Choose the Step Type, enter its name and relevant details, and select the required form or assessment when applicable.
Set Auto Complete where available, then select Create Step. Use Edit Step to change an existing step.
For a Manual step that needs supporting work, open its menu and select Add Substep. Choose Task, Form, or Assessment and decide whether Required should be on.
Arrange the top-level steps in the intended order using the drag handles. Substeps stay grouped beneath their parent.
Required and optional substeps
Substeps organize the work within a Manual step. A parent step is the stage containing that work—not the previous step in a sequence.
Required on: The substep must be included with its parent, and the parent cannot complete while that required work remains unresolved.
Required off: The substep is optional. It can be included for a participant but does not hold up the parent’s completion or the next stage.
Supported structure: Only top-level Manual steps contain substeps. Substeps are Task, Form, or Assessment steps; they do not contain further substeps.
Auto Complete on a parent: This option becomes available when the Manual step has required substeps. Enable it after adding the required work if you want automatic parent completion.
Required work is resolved when it is completed or given an applicable ending outcome, such as Incomplete or, on a sequential pathway, Skipped. Those outcomes can allow the parent and sequence to move forward, but they do not mean the substep was successfully completed.
How sequential pathways work
With Sequential enabled, the order of the participant’s included top-level steps controls what can start next. Later steps wait until earlier included steps are complete, skipped, or marked incomplete.
Steps that are not included for that participant do not block the sequence.
A parent’s required substeps must be resolved before the parent can complete. Optional substeps do not block completion.
Substeps follow their parent’s availability, not a separate sequence between sibling substeps. Their generated work also waits for the parent to start.
An available Manual step still needs a recorded start. Available Task, Form, and Assessment steps can generate their work automatically as the sequence advances.
With Sequential off, top-level steps can be started independently. Their generated work waits until the step is started.
Example: An intake workflow could have a Manual “Intake” stage with a required consent Form and eligibility Assessment, followed by a Task to schedule orientation. Once the required intake work is resolved and Intake is completed, the orientation task becomes available. Turning on Auto Complete for Intake removes the separate manual completion action for that stage.
Manage a participant’s workflow
Open the participant’s Pathways area and add or open the relevant pathway.
Include the steps that apply to this participant and assign supporters. Required substeps stay included with their parent.
Start available Manual steps or, for a non-sequential pathway, start the steps whose work should begin.
Review the step’s work and assignee in the pathway details. For Form or Assessment work, use its fill link; use View response to review an existing response.
Complete the linked task or response. If the step shows Ready to complete, record completion manually.
Review remaining steps and any required work before moving to the next stage.
Generated work is assigned to the step’s supporter, or to the parent step’s supporter if the substep has no supporter of its own. If neither is assigned, the pathway flags the work as unassigned. Add a supporter so ownership is clear.
Step statuses and outcomes
Not Started: The step has not begun. In a sequential pathway, it may also be waiting for earlier steps.
In Progress: The step has started but has not been completed or otherwise ended.
Complete: The step meets its completion requirements, including required substeps where applicable.
Incomplete: Work ended without successful completion. This can release later steps in a sequential pathway.
Skipped: The step was intentionally passed over. This option is available only on sequential pathways and can release the next step.
Record the appropriate outcome and any relevant reason or notes rather than marking unfinished work complete just to advance the workflow. Incomplete and Skipped do not count as successfully completed steps.
Close or reopen a pathway
Closing a pathway ends that participant’s current round; it is separate from completing every step. Resolve all in-progress steps first by completing them or recording an applicable ending outcome. Not-started steps do not prevent closure. Closing also stops outstanding generated work.
Reopening a pathway allows eligible work to resume. To correct an individual step’s recorded outcome, reopen the pathway first if it is closed, then use the available step action. Review the confirmation carefully: reopening a manually ended step removes its outcome and end date while retaining its start date.
For automatically completed steps, completion follows the linked work rather than an independently editable end date. Reopening required work can make a parent no longer complete, but it does not erase downstream work already created.
Customization and options
Sequential: Control whether included top-level steps must be resolved in order.
Step Type: Match each stage or action to Manual, Task, Form, or Assessment.
Required: Decide whether a substep must be resolved before its parent completes. This setting applies to substeps, not top-level steps.
Auto Complete: Automate completion for Form and Assessment steps, or Manual parents with required substeps.
Participant setup: Choose included steps and assign supporters for each participant.
Additional details: Use descriptions, codes, categories, and available custom fields to support your process.
Best practices
Use Manual steps for major stages and substeps for the work needed within them.
Mark only genuinely necessary substeps as Required.
Use Auto Complete when no separate staff review is needed after the required work qualifies.
Assign supporters before work begins so generated tasks have a clear owner.
Test the complete workflow with a sample participant before using it broadly.
Review existing participant progress before changing the structure or requirements of a workflow already in use.
FAQs
Why can’t I start the next step?
Check earlier included steps and any required substeps. An earlier step may still need completion or an ending outcome. A Manual parent may also need to be completed manually if Auto Complete is off.
Why didn’t submitting a form finish the step?
If the form requires approval, approval must happen first. If Auto Complete is off, a team member must complete the step after the response qualifies. Also confirm that the response was completed through this enrollment’s step work.
Does optional work hold up the next stage?
No. Optional substeps do not prevent the parent from completing. Required substeps must be resolved.
Can I use an existing form response to satisfy a Form step?
Simply attaching an existing response to a pathway does not satisfy the workflow requirement. The step checks responses associated with its own request for the current participant and enrollment.
What should I do if a step says Work not created?
Review the displayed explanation. Confirm that the required form or assessment is selected and available, correct the issue, and select Retry. Contact Equip Support if the problem continues.
Can the same participant follow the pathway again?
Yes, in a new round after the prior round is closed. The new round has its own progress and work; prior-round responses do not automatically complete its steps.
