SayCraft

← Blog

User Flow Template With Diagram and Worked Example

By SayCraft Team · 2026-08-27 · 9 min read

A useful user flow shows how a person reaches an outcome and what happens when the happy path breaks. Begin with an entry point and user intent, then record each screen or state, system response, decision, failure or recovery path, analytics question, and exit condition. Include permissions plus loading, empty, validation, and error states that change what the person can do next. The copyable table below works when the team needs to agree behavior before drawing screens or building a prototype. It does not replace a journey map for the wider experience or a wireframe for layout.

Copyable user flow template

StepUser intentScreen/stateSystem responseDecisionFailure / recoveryAnalytics question
1Enter the workflowEntry pointLoads eligible recordSigned in and permitted?Sign in or permission messageWhich entry source and permission outcome occurred?
2Understand current stateLoading → content/empty/errorReturns data or explicit statusRecord available?Retry, create first record, or exitWhich state caused an exit or retry?
3Complete the actionForm or review stateValidates and submitsInput valid?Keep input, explain error, focus correctionWhich validation or failure blocked completion?
4Confirm outcomeSuccess statePersists result onceAnother action needed?Return to list or safe next stepDid success lead to the intended next task?

Plain-text diagram: client draft approval

Invite link (entry)
  ├─ not signed in → sign in → validate invitation
  ├─ expired invitation → explain → request new invite (exit)
  └─ valid invitation → load draft
       ├─ loading fails → retry or contact owner
       ├─ no current draft → empty state (exit)
       └─ draft ready → review
            ├─ approve → confirm once → approval receipt (success exit)
            └─ request changes → require comment → saved request (success exit)

Worked flow table

StepStateEvidence questionAnalytics question
Open inviteValidating invitationCan the client tell that access is being checked?Which entry source reaches valid, expired, and denied outcomes?
Review draftReady with version labelDoes the client know which version the decision affects?Where do loading, empty, permission, and error exits occur?
Submit approvalSubmitting; controls disabledCan repeated clicks create duplicate decisions?How often does validation block submission or retry follow failure?
FinishApproval receiptCan the client and designer retrieve the same decision later?Does success lead to retrieval or the intended next task?

Payment success, failure, cancellation, and retry states

A payment flow needs more than success and failure. Model the processor result, the product state, and the user's safe next action separately. Do not mark an order paid from a client-side success screen alone; the authoritative payment event and idempotency rules belong to the payment integration.

StateWhat the interface should explainSafe next action
ProcessingThe payment result is not yet final and duplicate submission is blocked.Wait for the authoritative result or return safely.
SucceededThe accepted amount, item, receipt, and resulting access are clear.Continue once; repeated callbacks must not duplicate fulfillment.
FailedThe payment did not complete without exposing sensitive processor detail.Retry with the same order or choose another supported method.
CanceledNo completed payment was recorded and the reserved action was released or retained by policy.Return to checkout without creating a duplicate order.
RetryingThe product distinguishes a retry from a new purchase.Preserve the order identity and show the new attempt result.

A user flow maps interaction states. A journey map includes the broader experience across channels and time. A wireframe shows layout. Use this flow to populate an app prototype template and translate system responses into functional requirements.

Turn the document into something testable

Bring one completed flow—including its failures—to the live builder. A preview that covers only the success route has not yet implemented the approved flow.

Build a free live preview →

Frequently asked questions

What is a user flow?

A user flow maps the sequence of user intent, interface state, system response, decisions, and exits required to reach an outcome.

What should a user flow include?

Include an entry point, success exit, decisions, permissions, and loading, empty, error, and recovery paths relevant to the workflow.