A named stage in a user journey that groups a sequence of actions leading to a milestone.
A journey phase is a high-level stage of a user's experience over time: awareness, onboarding, habitual use, renewal. It is the coarsest band on a journey map, the chapter heading under which the smaller moments sit. Its jobJobUserJob To Be Done: what the user is trying to accomplishView reference → is to give a long, messy sequence of interactions a shape a team can reason about, so a roadmapRoadmapProduct SpecificationA strategic plan of features and milestonesView reference → conversation can name where in the arc a problem lives before arguing about which screen to fix.
Journey mapping grew out of service design and customer-experience practice, where the recurring move is to lay a person's interactions on a timeline and read the emotion and friction along it. The Nielsen Norman Group defines a journey map as a visualisation of the process a person goes through to reach a goal, built by compiling actions into a timeline and then layering thoughts and emotions on top. Phases are the top band of that timeline, with steps and actions nested beneath.
The phase vocabulary settled around familiar arcs (awareness, consideration, purchase, retention, advocacy) borrowed from marketing-funnelFunnelGrowthA conversion funnel tracking user progressionView reference → thinking, though product teams now write phases specific to their own product rather than the generic five. The useful discipline is keeping phases few; a map with twenty phases has just renamed its steps.
A team mapping a project-management tool settles on four phases: Evaluate, Set Up, Adopt, Expand. The Set Up phase holds the steps a new admin walks through, create a workspace, invite the team, import existing projects. Reading the emotional line across phases, confidence sits high at Evaluate, drops sharply through Set Up, and recovers only at Adopt. That single observationObservationUser ResearchA specific behaviour or statement observedView reference → reframes the roadmap: the product does not have an adoption problem, it has a setup problem, and the fix belongs to three steps inside one phase.
In the Unified Product Graph, a journey phase sits in the Experience, Design & Brand region as a container, one rung below the User JourneyExperience DesignAn end-to-end map of a user experienceView reference → anchor. A user_journeyUser Journeypasses throughJourney Phasehierarchy edge places it within its arc, and a user_journey_passes_through_journey_phaseJourney Phasehas stepJourney Stephierarchy edge nests the steps beneath it. That two-level containment keeps the map navigable: a team can read the experience at chapter resolution across the phases, then drill into the steps and actions of the one phase where the emotional line dips, without flattening a long journey into an undifferentiated list of moments.journey_phase_has_step
Type-specific fields on BaseNode
phase_ordernumberDisplay order within the journey (0-indexed)
labelstringShort human-readable name. @example "Discovery", "Onboarding", "Activation"
goalstringWhat the user is trying to accomplish
emotion_arcstringDirectional shape of user emotion. Spots design opportunities at dips and payoff points at peaks.
entry_triggerstringEvent or signal marking entry into this phase
exit_triggerstringEvent or signal marking exit. Pairs with the next phase's `entry_trigger`.
key_questionsstring[]Open questions the user asks themselves. Fuel for design and content priorities.
timeframestringTypical time window. @example "first 30 seconds", "days 1–7", "onboarding week"
idstringrequiredUnique identifier (UUID)
typeNodeTyperequiredDiscriminator for the entity type
titlestringrequiredDisplay name
descriptionstringOptional detailed description
statusstringLifecycle status
tagsstring[]Freeform tags for filtering
2 edge types connected to this entity.
user_journey_passes_through_journey_phasejourney_phase_has_step