Edmissa docs

Pipeline stages

Configure the steps, rules, requirements, approvals, access, and notifications inside an application pipeline.

Stages are the working steps inside a pipeline. They tell users where an application is right now, what should happen next, and which rules apply before the application can move forward.

Use this guide after the pipeline itself is created. If you need to create the pipeline first, start with Pipelines.

What this guide helps you configure

Use this guide when you need to set up the options inside a stage.

Stage configuration can control:

  • The stage name, type, color, and description.
  • Expected and maximum time in the stage.
  • What happens when an application stays too long.
  • Whether the stage is required.
  • Whether approval is needed before work continues.
  • Which roles can work in the stage.
  • Whether users can move applications backward from or through the stage.
  • Which roles are notified when applications enter the stage or become delayed.
  • Which checklist templates apply at the stage.

Before you start

Prepare these items before you configure stages:

ItemWhy it matters
Pipeline stage orderStage rules make more sense when the order is already agreed.
RolesAccess, approvals, and notifications depend on role setup.
Document typesStage requirements may ask for specific documents.
FieldsStage requirements may ask for important application details.
Checklist templatesStages can assign checklist work to the right person.
Approval processApproval settings need clear reviewer roles and next actions.

Keep the first version practical. It is better to start with clear stage names, simple requirements, and a few useful notifications than to create a workflow that is hard for the team to use.

Open the stage list

Use this path when you want to edit stages:

  1. Open Settings.
  2. Go to Pipelines.
  3. Stay on Active Pipelines.
  4. Find the pipeline you want to update.
  5. Open the three-dot menu on the pipeline card.
  6. Select Edit.
  7. Go to Pipeline Stages.

The Pipeline Stages area includes Expand All, Collapse All, and Add Stage. Each stage appears as a stage card. A collapsed card shows the stage number, stage name, stage type, and badges such as Approval. Use the drag handle to reorder stages. Expand a stage card to edit its details.

Pipeline Stages section with the Initial Consultation stage expanded.
Expanded stage cards show stage details, timing, requirements, approvals, movement controls, access, notifications, and checklists.

How to think about a stage

A stage should represent one clear work state. It should answer the question: what is happening with this application right now?

Good stage names are short and familiar, such as Document Collection, Visa Application, or Pre-Departure. Avoid names that only describe a task, a person, or a private internal shortcut.

Use fewer stages when the work is simple. Use more stages only when the team needs separate ownership, requirements, reporting, or approvals.

Stage details

Start with the basic details at the top of the expanded stage card.

SettingHow to use it
Stage NameEnter the label users will see in the workflow.
Stage TypeChoose what the stage means for status, reporting, and final outcomes.
Stage ColorChoose the color users will see on stage views and pipeline cards.
DescriptionExplain what should happen while the application is in this stage.

Write descriptions in plain operational language. A user should understand what to check, collect, submit, review, or confirm while the application is in that stage.

Stage type

Stage Type gives Edmissa the meaning behind the stage. The stage name can match your agency language, but the type should match the actual workflow state.

Stage typeUse it when
NewThe application has just entered the pipeline.
In ProgressWork is actively happening.
On HoldThe team is waiting for the student, institution, partner, payment, or result.
CompletedThe application reached a successful final outcome.
WithdrawnThe student stopped the process.
FailedThe application reached an unsuccessful final outcome.
LostThe student chose another path before the agency completed the process.

Be careful with final stage types. Completed, Withdrawn, Failed, and Lost can affect how applications are reported and reviewed later.

For Student Visa Processing, choose one clear successful outcome pattern:

PatternStage type guidance
Visa Approved is the final successful outcomeSet Visa Approved to Completed. Manage pre-departure work with tasks or follow-ups outside the application pipeline.
Pre-Departure is the final successful outcomeKeep Visa Approved as In Progress, then set Pre-Departure to Completed when travel and handover support are done.

Do not set Visa Approved to Completed if users still need to move the same application into Pre-Departure. Reports may show the application as complete before the team has finished the remaining work.

How stage settings work together

Some pipeline settings and stage settings affect the same movement or notification behavior. Review these pairs before you turn on strict rules.

SettingsHow they work together
Allow Skip Stages and Required StageAllow Skip Stages lets users skip stages only when the stage is not required. Turn on Required Stage for steps that must never be skipped.
Prevent Backward Movement and stage movement controlsPipeline-level backward prevention affects the whole workflow. Stage movement controls are more targeted and should be used for milestone stages.
Auto Progression and duration actionsAuto Progression controls automatic movement through the workflow. Duration actions only run when a stage exceeds its maximum duration.
Notify on Delay and automation notificationsNotify on Delay tells roles when a stage is taking too long. Automation notifications tell roles when an automatic action actually happened.
Approver verification and stage checklistsApprover verification is for the reviewer. Stage checklists are for the user doing the stage work. Use both only when both people have real work to confirm.
Stage settings and Pipeline Form ManagementStage settings control rules and movement. Pipeline Form Management controls which form template users see in each stage.

Timing

Use timing settings when the team needs to see whether work is moving at the right pace.

SettingHow to use it
Expected Duration (days)Enter the normal number of days an application should stay in the stage.
Max Duration (days)Enter the longest acceptable number of days before the application needs attention.
When Duration ExceededChoose what happens after the maximum duration is reached.

When Max Duration is set, choose one duration action:

ActionWhat it does
Do Nothing (notify only)Sends a notification, but does not move or archive the application.
Archive ApplicationArchives the application automatically. Use this only when the rule is clear and safe.
Move to Another StageMoves the application to a selected stage automatically.

Use automatic movement carefully. It works best for clear waiting states, such as a stage where an application should move to On Hold after a deadline. For important student work, notify the team first unless the agency has a firm process.

Stage requirements

Stage Requirements control basic behavior before an application can continue.

SettingHow to use it
Required StageTurn this on when the stage must be completed before users can move past it.
Requires ApprovalTurn this on when a reviewer must approve the work before it continues.

Use Required Stage for steps the team must never skip, such as document review or visa submission. Leave it off for optional support stages, such as Interview Preparation when only some students need it.

Required fields and required documents can also affect whether an application is ready to move forward. Keep requirements focused on information users truly need at that point in the workflow.

Approval roles

When Requires Approval is turned on, the Approval Roles setting can appear. Use it to choose which roles can approve applications at that stage.

Leave Approval Roles empty only when any user with approval permission can review the stage. Select roles when approval should belong to a specific group, such as managers or senior application officers.

For Student Visa Processing, approvals are useful before high-risk moments:

  • Before University Application when a senior officer checks the application pack.
  • Before Visa Application when a manager checks financial documents and form details.
  • Before Visa Approved when the team confirms the outcome and next steps.

Approver verification

Require Approver Verification can appear when approvals and checklist templates are available.

Use this setting when the approver must complete a checklist before approving, declining, or requesting revision.

SettingHow to use it
Verification Checklist TemplateChoose the checklist the approver must complete.
Verification Blocking ModeChoose how strictly the checklist blocks approval.
Hard Block (Required)The approver must complete the checklist.
Soft Block (Override allowed)The approver can override the checklist with a reason.

Use hard blocking for compliance-sensitive reviews. Use soft blocking when the approver may need flexibility but should still explain why the checklist was not completed.

Approval actions

Approval Actions control what happens after approval or decline.

SettingOptions
When ApprovedStay in Current Stage or Move to Stage.
When DeclinedStay in Current Stage, Archive Application, or Move to Stage.
Target StageThe stage Edmissa should move the application to when Move to Stage is selected.
Revision LimitsThe maximum number of revision requests allowed. Leave empty for unlimited revisions.

Use Stay in Current Stage when the reviewer only needs to record a decision. Use Move to Stage when the decision should carry the application forward or send it back to a correction stage.

Use Archive Application on decline only when the agency has a clear rule that the application should stop.

Automation notifications

Automation Notifications can appear when a stage has an automatic action, such as duration movement or approval movement.

SettingHow to use it
Automation NotificationsSend notifications when automatic actions happen.
Notify RolesChoose which roles should be notified. Leave empty to use default roles.

Keep this on for important actions. Users should know when an application moved or was archived because of a rule.

Movement controls

Movement Controls decide how applications can move backward around a stage.

SettingHow to use it
Prevent Backward From This StageStops applications from moving backward after they reach this stage.
Prevent Skipping Through When Moving BackwardStops users from skipping this stage while moving an application backward.

Use Prevent Backward From This Stage for milestone stages where going back would create confusion, such as Visa Approved.

Use Prevent Skipping Through When Moving Backward when the stage must remain visible during corrections. For example, if a visa application needs revision, the team may need to move back through Document Collection instead of jumping past it.

Stage access control

Stage Access Control decides which roles can access and work on applications in a stage.

SettingHow to use it
Access TypeChoose All Roles or Selected Roles Only.
Allowed RolesChoose the roles that can access the stage when Selected Roles Only is used.

Use All Roles when the stage does not need special access control.

Use Selected Roles Only when the stage belongs to a specific team. For example, Application Officers may handle University Application and Visa Application, while Counsellors may handle Initial Consultation and Pre-Departure.

Be careful when using Selected Roles Only. If no roles are selected, users may not be able to access applications in that stage.

Notifications

Notifications help the right roles know when stage work needs attention.

SettingHow to use it
Notify on EntrySends a notification when an application enters the stage.
Notify on DelaySends a notification when an application is delayed in the stage.
Entry Notification RolesChoose who should be notified on entry.
Delay Notification RolesChoose who should be notified on delay.

Use Notify on Entry for stages where another role must start work quickly, such as University Application or Visa Application.

Use Notify on Delay for stages with deadlines, such as Document Collection or Visa Application. Avoid notifying too many roles. The best notification is one that reaches the person who can act on it.

Checklists

The Checklists section appears when checklist templates are available. Use it to assign checklist templates that should be completed at the stage.

Each assigned checklist shows its template name, blocking mode, item count, and completion responsibility.

SettingHow to use it
Add checklist template...Assign another checklist template to the stage.
AssigneeThe assigned user is responsible for completing the checklist.
CreatorThe user who created the checklist is responsible for completing it.
AnyoneAny user with access can complete the checklist.

Use checklists for work that users should complete consistently, such as document pack review, visa form review, or pre-departure guidance. Keep checklists short enough that users trust them.

Student Visa Processing example

Use these recommendations as a practical first version for Student Visa Processing. Adjust the details for your market before live use.

StageStage typeOwner roleRequired information and filesChecklist or approvalNotification
Initial ConsultationNew or In ProgressCounselorStudent details, destination interest, intake, study level, budget, and assigned counselor.Use a consultation checklist if the team follows a fixed call structure.Notify the counselor on entry if assignment is handled by another role.
Document CollectionIn ProgressCounsellor or application officerIdentity, academic, financial, and language documents that apply to the destination.Add a document review checklist.Notify on delay when missing documents often slow the process.
University ApplicationIn ProgressApplication officerInstitution, program, intake, deadline, and submission details.Add approval before submission when a senior officer must review the application pack.Notify the application officer on entry.
Acceptance ReceivedIn Progress or On HoldCounselor and application officerOffer or acceptance document and next action notes.Add a checklist for offer conditions if your team tracks them inside the application.Notify the counselor and application officer on entry.
Visa ApplicationIn ProgressApplication officerVisa form details, acceptance document, financial evidence, and submission notes.Add approval before submission when managers review sensitive cases.Notify the application officer on entry and notify on delay when deadlines matter.
Interview PreparationIn Progress or On HoldCounsellorInterview date, interview requirement, and preparation notes when needed.Add checklist items for appointment booking, mock interview, document pack review, and student guidance.Leave Required Stage off if only some students need it.
Visa ApprovedIn Progress or CompletedApplication officer or managerVisa outcome and approval document.Use Completed only if this is the final successful outcome.Notify the team on entry.
Pre-DepartureIn Progress or CompletedCounselorTravel guidance, enrollment reminders, arrival notes, and final support details.Use Completed only if this is the final successful outcome.Notify the counselor on entry if the team supports students after approval.

Do not force every stage to have the same amount of configuration. Some stages only need a name, type, and description. Other stages need requirements, checklists, approvals, access control, and notifications.

Common exceptions

Plan how your team should handle exceptions before the pipeline goes live.

SituationRecommended handling
Student withdrawsMove the application to a Withdrawn stage or another stage with the Withdrawn type.
Visa is refusedMove the application to a Failed stage unless the team will immediately prepare a new submission.
Offer is rejectedUse a Failed or Lost stage, depending on whether the institution rejected the application or the student chose another path.
Intake is deferredUse On Hold if the application will continue later. Add a task or note for the new intake.
Documents are missingKeep the application in Document Collection and use Notify on Delay.
Interview is not requiredLeave Interview Preparation as optional, or allow users to skip it when the stage is not required.

Test stage settings

Before using stage settings for live work:

  1. Create a sample application.
  2. Move it through each stage.
  3. Confirm required fields and documents appear at the right time.
  4. Confirm checklist items match the work users actually do.
  5. Confirm approvals go to the right roles.
  6. Confirm approval actions move or keep applications where expected.
  7. Confirm notifications go to the right roles.
  8. Confirm movement controls allow the right changes and block the wrong ones.
  9. Confirm final stage types appear correctly in reports.

Ask one counselor and one application officer to test the workflow if both roles will use it.

Good stage habits

  • Use one stage for one clear work state.
  • Keep stage names short and familiar.
  • Use final stage types only for true outcomes.
  • Add required items only when they help users work correctly.
  • Use approvals for meaningful review points, not ordinary updates.
  • Send notifications to the roles that can act.
  • Review stage performance after the team has used the pipeline for a few weeks.
GuideUse it for
PipelinesCreate or review the workflow before editing individual stages.
Pipeline form managementChoose which form template users see at each stage and for each role.
ChecklistsAttach repeatable task lists to stage work when users need guided steps.
Form templatesDesign the forms that users may see while working in a stage.
FieldsCreate the fields used by requirements, forms, filters, and reports.
Document typesDefine the file categories that stage requirements may ask for.
NotificationsConfigure messages sent when applications enter stages or become delayed.
ApplicationsSee how stage configuration affects daily application work.