Skip to main content

Assign a form to pathway steps

Turn on Assign to Pathway Steps when editing a form and pick the steps; team members then open the form from the Document button on a started step, with the participant and step already attached to the response.

Written by MaryGrace Flores

To assign a form to pathway steps, open Forms, edit the form, turn on Assign to Pathway Steps and pick the steps in the Pathway Steps picker, then save the form. Once a participant's step has started, team members see a Document button on that step on the participant's Pathways tab, with New and View entries for each assigned form. On View Details, use the Forms section instead. A response started from there is linked to that participant and that step.

Participants are labelled Clients, Students, Residents or Explorers depending on the account type. This article calls them participants.

Who can do this, and where

  • Assign forms to steps on the web. Team members can also open assigned forms from a started step in the mobile app, as described below.

  • Assigning needs a role that can edit forms: the Forms module at a level that includes edit, and the form must be one your account owns. A form shared to you by an umbrella account cannot be edited, so it cannot be assigned.

  • Completing an assigned form from a step needs the Pathways module at Viewer or higher to see the step and the Forms permission to fill in that form.

  • The Assign to Pathway Steps toggle only appears once Pathways is on for your account, and never on umbrella accounts. Pathways is turned on for your account by the Equip team. If you do not see the toggle, ask us to enable it.

Steps to assign a form

  1. Open Forms in the left sidebar and open the form.

  2. Open the form's menu and choose Edit Form.

  3. Turn on Assign to Pathway Steps.

  4. In Pathway Steps, pick the steps. Each option reads as the pathway name, a dash, then the step name. Select all ticks every Manual step offered in the picker.

  5. Save the form.

The form is now assigned to those steps. Editing the form again shows the same steps ticked; untick one, or turn the toggle off, to remove the assignment.

Steps to complete an assigned form from a pathway

  1. Open the participant's profile and choose Pathways in the left menu.

  2. Find the step. The Document button appears on a step that has a Start Date; a Not Started step shows nothing.

  3. Click Document and choose New followed by the form's name. The form opens with the participant as the subject and the step attached.

  4. Complete and submit the form.

  5. Choose View followed by the form's name to see the responses already linked to that step.

When Pathway Centralization is on, open the Forms section of View Details. Under Ready to Start · Step in Progress, select the form, choose the steps it is for, and select Start Form. This page does not use a Document button on each step.

Limits and what the errors mean

  • One form can be assigned to any number of steps, and one step can carry several forms. Each form gets its own New and View pair in the Document menu.

  • Turning Assign to Pathway Steps off, or saving with no steps ticked, removes every assignment of that form. Responses already completed are not deleted; they stay on the participant's Forms tab and stay linked to the step.

  • Deleting a step from the Pathway Library removes its form assignments. The deletion preview lists them as "N form assignments". Deleting a pathway removes the assignments of all its steps.

  • The picker lists Manual steps, not Task, Form, or Assessment steps. On a single-step pathway the step has the pathway's name, so the option reads as the same name twice.

  • This toggle assigns form shortcuts to Manual steps; it does not make the form required for completion. When Pathway Workflows is enabled, configure a Form step for required form work. Complete its associated response and obtain approval if required. With Auto Complete on the step completes from that response; with it off the step waits for staff to complete it. Linking an unrelated response to a step is not the same as completing its required request.

FAQ

Can I assign the same form to more than one pathway step?
Yes. Turn on Assign to Pathway Steps and tick as many steps as you need, across any pathways. Select all ticks every Manual step offered in the picker.

Why is there no Document button on a step?
The button only appears on a step that has a Start Date and at least one assigned form. Give the step a start date with Update Progress, or check that the form is still assigned under Edit Form.

What happens to completed responses if I remove a form from a step?
Nothing. The responses stay on the participant's Forms tab and keep their link to the step. Only the New and View entries disappear from the Document menu.

Can a form that was assigned to a step be filled in from the Forms page instead?
Yes. Assignment adds a shortcut on the step; it does not restrict where the form can be completed. A response started from the Forms page is not linked to the step unless you link it with Link to Pathways or Steps on the response.

Does the mobile app show assigned forms on a step?
Yes. Team members can open assigned forms from a started step in the new mobile pathway detail view. Custom forms open in the app; PDF forms open the web filling page. The participant’s own pathway view does not expose these assignment actions.

Do I need Pathways enabled to see this option?
Yes. The toggle only appears once the Equip team has turned Pathways on for your account, and it is never offered on umbrella accounts.

Related

  • Create a pathway and its steps

  • What are pathways and how do they work?

  • What does Pathway Centralization add?

  • Add custom fields to a pathway or step

Did this answer your question?