Scenario
A workflow appears to run correctly, but it never moves to the next state.
Common symptoms include:
- The workflow remains stuck in the same state.
- Transition arrows never activate.
- Actions tied to the next state never execute.
- Workflow history shows the workflow initiating successfully but never progressing.
This is a common SuiteFlow issue caused by transition conditions, execution timing, or conflicting customization logic.
Solution
Review the workflow transition configuration carefully to determine why the transition conditions are not being met.
Common causes include:
- Transition Conditions are never True
- Review the transition condition logic carefully.
- Common issues include:
- Incorrect field values
- Blank fields
- Wrong operators
- Incorrect status comparisons
- Workflow executes too early
- Certain field values may not exist yet during:
- Before Record Load
- Before Record Submit
- The transition may only work correctly after the record is saved.
- Incorrect Trigger Type
- Verify the workflow supports the required event:
- Create
- Edit
- View or Update
- A transition dependent on edits will not occur if the workflow only triggers on create.
- Transition Timing Restrictions
- Scheduled or delayed transitions may not process immediately.
- Review any timing or scheduling settings configured on the transition.
- State Conditions blocking entry
- The workflow may never fully enter the source state due to state entry conditions failing.
- Multiple Workflows or Scripts
- Another workflow or SuiteScript may modify field values before the transition evaluates.
- Record Locking or Approval Status
- Locked, approved, or closed records may prevent transitions that require record updates.
- Incorrect Internal Values
- List or status fields may require internal IDs instead of displayed text values in workflow logic.
Notes
Workflow transitions are highly dependent on execution timing and field availability. A transition that appears logically correct may still fail if the required field values are unavailable at the moment the transition evaluates.
When troubleshooting:
- Enable Workflow History tracking.
- Review the exact transition conditions.
- Test using the Administrator role.
- Simplify conditions temporarily.
- Verify field values directly on the record after save.
- Test transitions one condition at a time.
Testing workflow changes in a sandbox environment is strongly recommended before updating production workflows.