A stage in the customer lifecycle
A customer journey stage is a coherent phase of a person's relationship with a product, named for the mindset they hold while they are in it: awareness, consideration, onboarding, retention, advocacy. It groups the many small interactions into a chunk a team can reason about and design for. The discipline gets muddled when teams confuse the stage with the smaller units that live inside it.
The staged view of buying behaviour is old. In 1898 the advertising pioneer Elias St. Elmo Lewis sketched what later became the AIDA model): attention, interest, desire, action. It was a linear funnelFunnelGrowthA conversion funnel tracking user progressionView reference →, drawn from selling life insurance, and for most of a century it framed how marketers pictured a prospect's progress.
Two later movements reshaped it. Service design and the experience economy moved the focus from the seller's funnel to the customer's lived experience. B. Joseph Pine II and James H. Gilmore's The Experience Economy (1999) argued that businesses stage experiences, which pushed practitioners to map the whole arc a customer travels, including the parts that happen after purchase. Customer journey mapping grew out of this lineage as a way to chart stages, the emotions inside them, and the moments that make or break each one.
Then McKinsey broke the straight line. Its 2009 Consumer Decision Journey, based on the purchase decisionsDecisionStrategyA recorded decision with context, rationale, and consequencesView reference → of nearly 20,000 consumers, replaced the funnel with a loop, observing that real buyers move iteratively through consideration and evaluation and, once loyal, can skip straight back to repurchase. The field has since landed on a pragmatic position: stages remain a useful organising abstraction, provided the team accepts that customers move through them non-linearly, doubling back and skipping as they go.
A B2B analytics product maps its post-signup journey into stages: activation, habit formation, expansion, advocacy. The activation stage is defined by a single mindset, "can I get one real answer out of this." Inside that stage sit the concrete units. The journey stepsJourney StepExperience DesignA single step in a user journeyView reference → are the actions a user takes (connect a data sourceData SourceData & AnalyticsA data source or integrationView reference →, build a first chart). The touchpointsTouchpointCustomer SuccessA customer interaction touchpointView reference → are the surfaces where the product meets them (the onboarding email, the empty-state hint, the support chat).
When the team finds that 40% of signups never reach habit formation, the stage boundary tells them where to look. They instrument the funnel stepsFunnel StepGrowthA stage within a conversion funnelView reference → inside activation and discover the drop sits at "connect a data source," a single step. Fixing that one touchpoint, a clearer connector picker, lifts stage-two arrival from 60% to 78%. The stage framed the problem; the smaller units located it.
In the Unified Product Graph, a customer journey stage sits in the customer success domain as the organising layer of the experience. It spans its constituent actions through Customer Journey StagespansJourney Stepcross-domain, holds the surfaces of contact through customer_journey_stage_spans_journey_stepCustomer Journey StagecontainsTouchpointhierarchy, and holds its measurable gates through customer_journey_stage_contains_touchpointCustomer Journey StagecontainsFunnelcross-domain. A broader flow assembles stages in sequence via customer_journey_stage_contains_funnel_stepUser FlowcontainsCustomer Journey Stagehierarchy, and operational play attaches through user_flow_contains_customer_journey_stagePlaybooktargetsCustomer Journey Stagecross-domain. The structure keeps the abstraction layers distinct: mindset (stage), action (step), surface (touchpoint), and metric (funnel step) each have their own home, so a team can move between the chapter and the line without collapsing one into the other.playbook_targets_customer_journey_stage
Type-specific fields on BaseNode
stage_typestringWhich pirate metric (AAARRR) this stage maps to
avg_durationstringAverage time a customer spends in this stage
conversion_ratenumberPercentage of customers who advance to the next stage
idstringrequiredUnique identifier (UUID)
typeNodeTyperequiredDiscriminator for the entity type
titlestringrequiredDisplay name
descriptionstringOptional detailed description
statusstringLifecycle status
tagsstring[]Freeform tags for filtering
5 edge types connected to this entity.
user_flow_contains_customer_journey_stagecustomer_journey_stage_contains_touchpointcustomer_journey_stage_contains_funnel_stepcustomer_journey_stage_spans_journey_stepplaybook_targets_customer_journey_stage