A user need, pain, desire, or constraint. The canonical type for what users struggle with, want, or are blocked by.
A need is the stable underlying requirement a person carries into a situation, the thing that stays true whatever solutionSolutionDiscoveryA proposed approach to address an opportunityView reference → they end up using. A want names a particular solution they have in mind; a need names the state they are trying to reach. The discipline of product work is to find the need beneath the want, because the want changes with every new option on the market and the need barely moves.
The need-versus-solution distinction has a long pedigree in marketing, but its sharpest modern statement comes from the jobsJobUserJob To Be Done: what the user is trying to accomplishView reference →-to-be-done tradition. Theodore Levitt's line, often repeated, captured it: people who buy a quarter-inch drill do not want a drill, they want a quarter-inch hole. Anthony Ulwick built a formal method on the same instinct, arguing in Defining Customer Needs that most teams confuse needs with solutions, specifications, or vague benefit statements, and that a need is properly framed as a measurable outcomeOutcomeStrategyA desired business or user outcomeView reference → the customer wants from getting a job done.
A recurring split in the literature is between articulated and latent needs. Articulated needs are the ones a person can state plainly, such as "I want longer battery life." Satisfying them tends to produce incremental improvement. Latent needs sit below conscious expression, and surfacing them is where larger product moves come from. One argument worth keeping is that latent needs are less mysterious than they sound: the usual block is shallow questioning, and repeated "why" follow-up draws them out.
The field's most common abuse is the Maslow pyramid. Abraham Maslow's 1943 paper A Theory of Human Motivation proposed a hierarchy, but he never drew a pyramid, and he never claimed one level must be fully met before the next begins. Bridgman, Cummings and Ballard traced the pyramid to a 1960 management graphic by the consultant Charles McDermid, not to Maslow at all. Teams that rank user needs into rigid tiers are quoting a diagram their source never endorsed.
A scheduling tool gets a steady stream of requests for a darker calendar themeThemeProduct SpecificationA strategic grouping of related featuresView reference →. Read as a want, the answer is to ship dark mode. The team instead interviews fifteen of the askers and finds the pattern underneath: most of them are checking the calendar late at night from bed, on a phone, and the bright screen wakes a sleeping partner. The need is to glance at tomorrow without disturbing anyone in a dark room. Dark mode serves part of it, but so does a low-brightness lock-screen widget that never opens the full app, which tests better. Six months later a new request arrives for a different colour scheme. The need has not changed; only the proposed solution has. Holding the need stable lets the team evaluate the new ask in seconds.
job_surfaces_needJobsurfacesNeedcausal rather than collapsing the two.In the Unified Product Graph, a need lives in the Users and Needs region and acts as the durable target beneath shifting feature requestsFeature RequestCustomer FeedbackA user-submitted feature requestView reference →. A personaPersonaUserAn archetype representing a user segmentView reference → reaches it through PersonaexperiencesNeedsemantic, a job exposes it through persona_experiences_needJobsurfacesNeedcausal, and a chosen bet attaches through job_surfaces_needOpportunityaddressesNeedcross-domain. Qualitative evidenceEvidenceValidationData supporting or refuting a hypothesisView reference → anchors it: opportunity_addresses_needFeedback ThemevalidatesNeedcross-domain ties a recurring theme to the need so it rests on observed demand, not assertion. The forward link feedback_theme_validates_needNeedfulfilled byCapabilityhierarchy then connects the requirement to whatever the product builds to meet it, so a featureFeatureProduct SpecificationA product capability or featureView reference → can always be traced back to the human requirement it serves. A need with no fulfilling capabilityCapabilityStrategyAn ability that enables value deliveryView reference → is a visible gap; a capability serving no need is visible scope creep.need_fulfilled_by_capability
Type-specific fields on BaseNode
statementstringThe need expressed as a clear, user-facing statement
valencestringWhat kind of experience: pain (friction), gap (unmet), constraint (limitation)
maturitystringHow mature is this need in our understanding
frequencyobjectHow often the user encounters this need (1 = rarely, 5 = constantly)
severityobjectHow painful or disruptive the need is when unaddressed (1 = minor, 5 = critical)
importanceobjectHow important resolving this need is to the user (1 = low, 5 = critical)
motivationstringMotivation dimension. Inherited from parent job if not set.
idstringrequiredUnique identifier (UUID)
typeNodeTyperequiredDiscriminator for the entity type
titlestringrequiredDisplay name
descriptionstringOptional detailed description
statusstringLifecycle status
tagsstring[]Freeform tags for filtering
3 phases — initial: raw
23 edge types connected to this entity.
need_reframed_as_design_questionneed_fulfilled_by_capabilityopportunity_addresses_needfeedback_theme_validates_needjourney_step_reveals_needneed_occurs_in_journey_stepfunnel_step_reveals_needvalue_proposition_solves_needsupport_ticket_reveals_needsupport_ticket_reveals_need_cross_domainchurn_reason_reveals_needinsight_validates_needinsight_validates_need_cross_domainobservation_reveals_needquote_evidences_needlearning_validates_needsolution_addresses_needcompetitor_addresses_needassumption_concerns_needfeature_addresses_needneed_measured_by_desired_outcome6 frameworks use this entity type.