QUICK ANSWER
What should a user flow template include?
A user flow template should name one actor, task, entry, observable screen or state at each node, user or system trigger, branch condition, visible result, retry rule, recovery path, success, and safe exit. It maps how a person completes a task; it does not replace a website sitemap, page wireframe, backlog user story, or business-record workflow.
A user flow should make one person's path through a digital task reviewable before interface polish hides missing behavior. It connects an entry point to screens, meaningful decisions, waiting states, visible errors, recovery, success, and a safe exit, with an observable result for every transition.
The downloadable pack contains six original fictional examples for support, account recovery, catalog search, appointment requests, file upload, and notification preferences. JSON is the controlled source; CSV and Mermaid views are generated from it, and dependency-free checks reject unreachable nodes, dead ends, ambiguous decisions, and missing recovery.

Build the flow around one observable task
Start with a user-recognizable goal, not the product navigation or internal organization chart. Then make the interface states and branch results explicit enough for design, engineering, QA, accessibility, and operations reviewers to challenge the same model.
Bound one actor, task, entry, and outcome
Name the specific actor and the one task they recognize. Record where the path begins, what observable result counts as success, and which adjacent task is outside scope. Figma describes user flows as steps toward a specific task, while GOV.UK recommends scoping transactions around a problem users recognize instead of organizational structure.
Sources: [figma-user-flow], [govuk-service-scope]
Turn screens and dynamic results into explicit nodes
Give every screen, waiting state, error, review, confirmation, and safe exit a stable ID. Describe what the person can perceive and do, not only the database state. W3C guidance makes error identification and status changes concrete accessibility concerns, so an unlabeled spinner or silent failure is not a complete flow node.
Sources: [user-flow-pack], [wcag-error-identification], [wcag-status-messages]
Write branches as conditions with visible results
For every transition, name the trigger, condition, destination, observable result, and retry rule. Decisions need at least two result branches. Errors need a recovery or safe exit. Preserve a meaningful focus sequence when a branch changes the interface, and never show success before the relevant result is confirmed.
Sources: [user-flow-pack], [wcag-focus-order], [wcag-status-messages]
Validate the graph before drawing detailed screens
Run the included checks for unknown references, duplicate IDs, unreachable nodes, dead ends, terminal exits, one-way error traps, missing branch coverage, and generated-file drift. Then review the model with real user evidence and only afterward hand approved nodes to wireframes, implementation stories, tests, and operational workflows.
Sources: [user-flow-pack], [figma-user-flow], [govuk-service-scope]
What this user flow resource owns
The pack owns observable task navigation: which surface or state a person sees, what causes each transition, how results branch, and how the person reaches recovery, success, or a safe exit. Adjacent planning artifacts keep their own jobs.
Included
- One blank Markdown template with actor, goal, entry, node, transition, terminal, acceptance, and scope fields
- Six fictional examples with 61 observable nodes and 75 transitions in a closed JSON model
- Generated CSV transition ledger and Mermaid overview with byte-parity checks
- Explicit waiting, invalid, retry, conflict, changed-result, recovery, success, and safe-exit paths
- Dependency-free validation, negative tests, JSON Schema, and deterministic allowlisted ZIP packaging
Not included
- Website information architecture, page inventory, hierarchy, canonical paths, navigation, or XML sitemaps
- Page layout, content hierarchy, responsive composition, interaction styling, or final visual wireframes
- Backlog user stories, product requirements, acceptance ownership, estimates, sprint commitments, or UAT signoff
- Durable business-record states across teams, server policy, approvals, provider side effects, or operational workflow design
- User research findings, usability proof, accessibility conformance, security approval, legal advice, deployment, or outcome claims
DOWNLOADABLE RESOURCE
Download the user flow template pack
Start with the blank Markdown file or adapt one fictional example. Keep JSON as the controlled source, regenerate the CSV and Mermaid views after each change, and run the checks before handing the flow to screen design or implementation.
User flow template and examples pack
Six original provider-neutral task flows for support requests, account recovery, catalog search, appointment requests, file upload, and notification preferences.
Format: Markdown, JSON, JSON Schema, generated CSV, generated Mermaid, validator, tests, and deterministic builder in one ZIP
Locally reproduced August 1, 2026. SHA-256: 35a17c16d41f6cd64a41f994b27987016636e766301b6670a6decec3e536ab89
Included
- Blank user-flow-template.md with review prompts and boundary questions
- Closed JSON model with six examples, 61 nodes, and 75 transitions
- Generated CSV transition ledger and Mermaid graph derived from JSON
- Strict validator and ten positive or negative Node.js tests
- Deterministic allowlisted ZIP builder with fixed timestamps
Verification boundary
Local checks passed for unique identities, exact object shapes, known endpoints, one entry per flow, reachable nodes, terminal reachability, decision branches, terminal sinks, visible status and error states, recovery and safe exits, five acceptance categories, privacy-safe fictional content, JSON Schema closure, CSV and Mermaid parity, exact archive contents, and repeatable ZIP bytes. The public URL and any adapted implementation remain separate verification gates.
Six user flow examples and the risk each exposes
Each example focuses on a person moving through interface states. The examples deliberately stop before the deeper record lifecycle or provider workflow so teams can connect, rather than confuse, those separate artifacts.
Support request user flow
Use when: A signed-in person submits one request and needs a durable reference without relying on an optional notification.
The flow separates validation, saving, confirmed reference, not-confirmed failure, exact retry, and a safe support exit. A confirmation appears only after the save result can be stated truthfully.
Structure
- Support home → Request form → Validation → Saving → Confirmation
- Validation error → Correct form; save failure → exact retry or safe exit
Watch for: Stop at the person-facing confirmation. Triage, assignment, provider notification, resolution, and audit belong in the support workflow and record model.
Sources: [user-flow-pack], [wcag-error-identification], [wcag-status-messages]
Account recovery user flow
Use when: A person cannot sign in and needs neutral recovery guidance, invalid-link recovery, and a safe support route.
The path keeps account existence private, separates identifier formatting from account lookup, routes expired links back to a new request, and confirms a change only once.
Structure
- Sign in → Recovery request → Neutral instructions → Link check → New secret → Confirmation
- Formatting error → Correct; expired link → New request; inaccessible link → Safe support exit
Watch for: The example does not choose identity proofing, delivery, rate-limit, fraud, session-revocation, or support policy. Those require separate accountable review.
Sources: [user-flow-pack], [wcag-error-identification], [govuk-service-scope]
Catalog search user flow
Use when: A visitor changes a query or filters and must distinguish matches, no matches, and technical unavailability.
The latest criteria remain visible during loading, late responses cannot overwrite newer choices, empty and failed results stay distinct, and every blocked state has refinement or retry.
Structure
- Catalog → Loading → Results gate → Result list → Item detail
- Empty → Relax criteria or safe exit; unavailable → Retry latest criteria
Watch for: Search ranking, catalog ingestion, moderation, inventory, and recommendation policy remain outside this visitor-path map.
Sources: [user-flow-pack], [wcag-status-messages], [wcag-focus-order]
Appointment request user flow
Use when: A visitor selects a candidate slot, reviews minimum contact details, and submits a request that may lose availability before confirmation.
The flow distinguishes no slots from a failed availability check, treats displayed slots as candidates, handles a changed slot without silent replacement, and returns not-confirmed submissions to retry or exit.
Structure
- Criteria → Availability → Slot → Contact details → Review → Submit → Confirmation
- No slots → Change criteria; changed slot → Recheck; not confirmed → Exact retry or safe exit
Watch for: The example does not claim a calendar integration, payment, reminder delivery, booking policy, or staff fulfillment workflow.
Sources: [user-flow-pack], [govuk-service-scope], [wcag-status-messages]
File upload user flow
Use when: A signed-in person selects one file, sees stated constraints, waits for upload, reviews safe metadata, and confirms or removes it.
Pre-upload rejection never appears as progress, progress never appears as saved, a failed attempt can retry without duplication, and review exposes a remove action before confirmation.
Structure
- Document page → Selection → Validation → Uploading → Review → Confirmation
- Invalid → Reselect; not confirmed → Retry or remove and exit
Watch for: Client-visible checks do not prove authorization, malware scanning, safe storage, retention, deletion, or document-review policy.
Sources: [user-flow-pack], [wcag-error-identification], [wcag-status-messages]
Notification preferences user flow
Use when: A signed-in person reviews optional choices and may encounter a newer saved version or an unconfirmed update.
The flow distinguishes optional choices from required notices, shows a before-and-after review, binds save to one version, prevents silent stale overwrite, and confirms effective settings rather than provider delivery.
Structure
- Current settings → Review changes → Saving → Confirmed effective version
- Stale version → Reload current settings; not confirmed → Retry or safe exit
Watch for: Consent law, required-notice policy, provider suppression, delivery, unsubscribe processing, and audit retention need separate review.
Sources: [user-flow-pack], [wcag-status-messages], [wcag-focus-order]
Choose the right planning artifact before you draw
A user flow is useful when the unresolved question is how one person reaches an outcome through interface states. Use these stop rules to keep neighboring artifacts from collapsing into one overloaded diagram.
The question is which pages exist and how they are organized
Choose: Use a website sitemap or information-architecture inventory, then start a user flow only for a bounded task that crosses those pages.
Tradeoff: You maintain two connected artifacts, but page ownership and task behavior remain independently reviewable.
The question is what one page looks like or contains
Choose: Use a wireframe for regions, content priority, responsive order, and controls. Link each flow node to the relevant wireframe version.
Tradeoff: The flow stays visually sparse, while page-level layout gets enough detail for design review.
The question is what a backlog item must deliver
Choose: Write a user story with acceptance evidence and reference the approved flow nodes and transitions instead of copying the whole diagram into the story.
Tradeoff: Traceability takes deliberate IDs, but implementation slices do not silently redefine the task path.
The question is how a durable record moves across actors or systems
Choose: Use a workflow state table for authoritative states, guards, side effects, retries, and audit. Keep the user flow focused on what one person sees and does.
Tradeoff: The UI path and business process require reconciliation, but provider or record failures no longer disappear behind a screen arrow.
A branch has no visible result, recovery, or safe exit
Choose: Keep the flow in review. Add the observable state and terminal path before detailed wireframes or implementation stories begin.
Tradeoff: Design starts later, but the team avoids polishing a path that can trap or mislead the person.
FROM PATH MODEL TO IMPLEMENTATION
Give every screen state an observable job
Replace the fictional actor, nodes, conditions, and recovery rules with reviewed evidence. Then give Playcode the approved flow as part of the implementation brief and test the result in a real browser.
Start BuildingThis resource is a planning pack, not a native user-flow generator or product screenshot.
What the template cannot prove
A structurally valid graph makes missing states easier to find. It does not prove that the chosen task, policy, copy, interaction, or implementation is correct for real people.
- The six examples are fictional provider-neutral planning records, not customer flows, product screenshots, or recommended business policy.
- Reachability and branch checks cannot prove user research, comprehension, task success, accessibility conformance, or usability.
- A visible UI state does not prove durable storage, authorization, idempotency, provider delivery, audit, retention, or recovery.
- The Mermaid overview is a review view, not a replacement for the JSON source, interface specifications, tests, or operational diagrams.
- The ZIP is verified locally but not publicly available until an authorized environment serves the exact bytes with the correct content type.
- This ordinary informational article does not claim a native user-flow generator or grant AI signup credits.
Sources and verification record
Current primary and first-party guidance supports the one-task scope, interface-state, error, status, and focus boundaries. The six models, fields, checks, examples, and adaptation rules are original Playcode editorial work.
[user-flow-pack] Playcode:User flow examples JSON model
Checked August 1, 2026. Supports: The six fictional flows, 61 observable nodes, 75 transitions, scope boundaries, acceptance checks, generated views, and structural validation described in this guide. Public availability remains unverified until deployment.
[figma-user-flow] Figma:What Is a User Flow?
Checked August 1, 2026. Supports: Defining a user flow around one actor and goal, entry, meaningful steps, decisions, endpoint, and the distinction from wireframes, journey maps, task flows, and sitemaps.
[govuk-service-scope] GOV.UK Service Manual:Getting the Scope of Your Transaction Right
Checked August 1, 2026. Supports: Scoping a transaction around one user-recognizable task and connecting it coherently to a wider journey without copying organizational structure into the experience.
[wcag-error-identification] W3C Web Accessibility Initiative:Understanding Error Identification
Checked August 1, 2026. Supports: Making detected input errors identifiable and describing them in text so a person knows what failed.
[wcag-status-messages] W3C Web Accessibility Initiative:Understanding Status Messages
Checked August 1, 2026. Supports: Exposing success, results, waiting, progress, and error status so assistive technologies can present important changes without unnecessary focus movement.
[wcag-focus-order] W3C Web Accessibility Initiative:Understanding Focus Order
Checked August 1, 2026. Supports: Preserving meaning and operability when people navigate sequentially through interactive content and changed interface states.
User flow template questions
What is a user flow?
A user flow maps how one actor moves through interface screens and visible states to complete a bounded task. It records entries, actions, decisions, results, errors, recovery, success, and safe exits so the path can be reviewed before detailed design or implementation.
What is the difference between a user flow and a user journey map?
A user flow focuses on actions and states inside a specific digital task. A journey or experience map can span a much wider period, multiple channels and services, and what people do, think, or feel before and after the interface task.
What is the difference between a user flow and a sitemap?
A sitemap inventories pages and their hierarchy or navigation relationships. A user flow traces one actor toward one outcome across relevant screens and states. A single flow may cross several sitemap pages, and one page may support several distinct flows.
What is the difference between a user flow and a wireframe?
A user flow explains transitions among screens and states. A wireframe explains the regions, content priority, controls, and responsive order inside one screen. Link nodes to wireframe versions rather than putting detailed page layout into the flow graph.
What is the difference between a user flow and a workflow diagram?
A user flow owns what one person sees and does in an interface task. A workflow diagram or state table can own a durable record moving across actors, server rules, provider side effects, retries, audits, and operational exceptions.
How detailed should a user flow be?
Include each meaningful screen, waiting state, decision, visible error, recovery, success, and safe exit. Skip decorative clicks that do not change the task state. Add detail when a branch changes what the person can observe, decide, retry, or recover.
Which file should I edit in the download?
Use the Markdown file for a blank review, or edit the JSON model as the controlled source for the examples. Then run the renderer and tests so the CSV and Mermaid files stay synchronized and invalid graph changes fail clearly.
Does a valid flow prove the product is usable or accessible?
No. Structural checks can expose missing paths and unobservable states, but real research, content review, interaction design, accessibility evaluation, implementation tests, target-environment smoke, and monitoring still need accountable evidence.
BUILD THE REVIEWED TASK PATH
Turn the approved flow into a working interface
Describe the actor, goal, records, permissions, screen states, branch rules, recovery, and evidence you need. Use Playcode to build the app, then verify each path before publishing.
Create With PlaycodeNo credit card required. AI credits included to start.