An end-to-end user journey map
A user journey is a structured account of how a person moves toward a goal over time, across the touchpointsTouchpointCustomer SuccessA customer interaction touchpointView reference → and stages of an experience, including what they do, feel, and want at each step. It stretches the unit of design analysis from a single screen to the whole arc, which is where most product failures actually live: in the seams between steps that each work fine alone.
The lineage runs through service design. G. Lynn Shostack introduced service blueprinting in the Harvard Business Review article "Designing Services That Deliver" (1984), mapping a service as a sequence crossing a line of visibility between what the customer sees and what the organisation does behind it. Ron Zemke and Chip Bell developed adjacent thinking through the 1980s. The specific practice of customer journey mapping was introduced by Oxford Corporate Consultants, now OxfordSM, in 1998 for Eurostar, to align a brand promise with the lived experience of a rail passenger.
The idea matured as digital experience grew more fragmented. Jim Kalbach's *Mapping Experiences* (2016) consolidated the field, distinguishing the variantsVariantGrowthA variant in an A/B testView reference → that had proliferated: the journey map centred on a personaPersonaUserAn archetype representing a user segmentView reference →'s emotional path, the experience map that abstracts across people, and the service blueprintService BlueprintCustomer SuccessA blueprint of the full service deliveryView reference → that adds the backstage organisation. Kalbach's framing was that these are alignment artefacts whose value comes from building shared understanding, and that a map disconnected from a real persona and a real goal is decoration.
A useful split emerged between current-state maps, which document the journey as it is, warts and drop-offs included, and future-state maps, which propose the journey as it should be. The first is a diagnostic; the second is a design target. Confusing them is how teams end up mapping an aspiration and mistaking it for reality.
A team maps the current-state onboarding journey for a primary persona, the time-starved solo operator. Five phases: discover, sign up, connect data, first value, habit. Each phase records the persona's action, their emotional state, and where they stall. The map exposes a seam invisible at the screen level: sign-up and data-connection each test well in isolation, but between them the user is asked to leave the product to find an API key, and thirty per cent never return. No single screen owns that failure; the journey does. The fix, an in-flow credential paste, targets the seam, and the future-state map records the intended path so the team can measure against it.
user_flow_maps_user_journeyUser FlowmapsUser Journeycross-domain.journey_type rather than a separate node.user_journey_addresses_jobUser JourneyaddressesJobcross-domain; one job can be served by many journeys.In the Unified Product Graph, User JourneyExperience DesignAn end-to-end map of a user experience is the anchor of the Experience, Design & Brand region, which makes sense: the journey is the spine that screens, flows, and prototypesPrototypeExperience DesignAn interactive mockup for testingView reference → attach to. Its user_journeyjourney_type property carries the current-state, future-state, day-in-the-life, and service-blueprint distinction so the diagnostic and the target never blur. Outbound, User JourneycontainsJourney Stephierarchy and user_journey_contains_journey_stepUser Journeypasses throughJourney Phasehierarchy build the temporal structure, while user_journey_passes_through_journey_phaseUser JourneymapsPersonacross-domain and user_journey_maps_personaUser JourneyaddressesJobcross-domain tie it to the who and the why. Inbound, user_journey_addresses_jobOpportunityimprovesUser Journeycross-domain lets a discovery finding point straight at the seam it should fix. A journey mapped to no persona is the most common decoration in product work, and here it is queryably orphaned.opportunity_improves_user_journey
Type-specific fields on BaseNode
scopestringScope (e.g. "end-to-end onboarding")
journey_typestringMaps current or future state
scenariostringScenario context
idstringrequiredUnique identifier (UUID)
typeNodeTyperequiredDiscriminator for the entity type
titlestringrequiredDisplay name
descriptionstringOptional detailed description
statusstringLifecycle status
tagsstring[]Freeform tags for filtering
4 phases — initial: draft · template: PUBLISHING
9 edge types connected to this entity.
product_maps_experience_via_user_journeydesign_system_encompasses_user_journeyuser_journey_contains_journey_stepuser_journey_passes_through_journey_phasepersona_experiences_user_journeyuser_journey_maps_personauser_journey_addresses_jobopportunity_improves_user_journeyuser_flow_maps_user_journey