Skip to content

Workflow States

When workflow is enabled on a project, submissions follow a state machine with defined transitions and permission gates.

StatusDescription
draftInitial state. Fields are editable.
submittedSubmitted for review. Fields locked (read-only).
under_reviewBeing reviewed by a manager. Fields locked.
approvedApproved. Fields locked.
rejectedRejected. Fields locked.
draft ──────► submitted ──────► under_review
▲ │ │
│ │ │
│ ▼ ▼
│◄──── rejected approved ────►│
│ │
└──────────────────────────────────┘
FromToRequired Permission
draftsubmittedcan_edit (own) or can_edit_all
submittedunder_reviewcan_manage
submittedapprovedcan_manage
submittedrejectedcan_manage
submitteddraftcan_edit (own) or can_edit_all
under_reviewapprovedcan_manage
under_reviewrejectedcan_manage
under_reviewsubmittedcan_manage
approveddraftcan_manage
rejecteddraftcan_manage

When workflow is enabled, fields can only be edited in draft status. Transitioning back to draft from any other state re-enables editing.

When enabled on the project, workflow transitions trigger email notifications:

  • Submission → under_review/approved/rejected: notifies the submission creator
  • Draft → submitted: notifies all partition managers (can_manage = true)