What are Archetypes and how do they work

Archetypes turn weeks of health and lifestyle signals into stable, human-readable labels for segmentation and personalization. Learn how Sahha archetypes work, the science behind the behaviors they represent, and how to use them in your product.

Archetypes convert weeks of health, lifestyle, and behavioral data into human-readable labels (e.g., night_owlshort_sleeperhighly_active). Unlike daily scores, archetypes are designed to be stable traits you can use for segmentation, targeting, personalization, and analytics — without overreacting to one-off days like travel, illness, or deadlines.


Key Takeaways

  • What they are: long-term behavioral labels derived from weeks of data.
  • Why they matter: archetypes are stable, segmentable, and easy to use in product logic.
  • What makes them credible: archetypes summarize validated behavioral dimensions (sleep, activity, sedentary behavior, recovery patterns) that have strong scientific links to health and wellbeing.
  • Best practice: treat archetypes as “profile traits,” and use daily scores/biomarkers for real-time nudges.

Metric Spec

ItemValue
Output typeArchetype assignment (label + metadata)
Typical cadenceWeekly and monthly refresh (some schemas may support longer cycles)
Best used forSegmentation, targeting, personalization, analytics/BI
Data requirementsVaries by archetype; most are smartphone compatible
Delivery methodsAPI (pull) or Webhooks (push)
Retroactive supportNew integrations can receive recent historical archetypes depending on availability

How Archetypes Work

Sahha analyzes weeks of data and assigns users to behavioral categories. Compared to day-level metrics, this “smoothing” reveals stable patterns and reduces noise.

There are two archetype types:

Ordinal archetypes (ranked progression)

Ordinal archetypes represent a ranked scale where categories move from lower → higher states in a meaningful order.

Example concept:

  • sleep_durationvery_short_sleeper → short_sleeper → average_sleeper → long_sleeper

These are useful for:

  • cohort comparisons
  • “improving vs declining” narratives
  • simple threshold-based journeys

Categorical archetypes (distinct groups)

Categorical archetypes group users into distinct categories without implying “better” or “worse”.

Examples in Sahha include:

  • primary_exercise_type (e.g., strength_orientedcardio_oriented)
  • sleep_pattern (distinct timing/consistency patterns)

These are useful for:

  • content routing
  • preferences and persona-style segmentation
  • personalization that shouldn’t be framed as a performance ranking

The Science Behind Archetypes

Archetypes are credible when they represent constructs that are (1) measurable from passive data(2) behaviorally meaningful over time, and (3) supported by evidence linking them to outcomes.

Sahha archetypes draw their meaning from the same evidence-backed dimensions used in Sahha’s score models:

1) Sleep archetypes map to validated sleep health dimensions

Modern sleep science treats sleep health as multi-dimensional. Beyond duration, dimensions like regularity, continuity, circadian alignment, sleep debt, and restorative stages each independently relate to health and functioning. Sahha’s Sleep Score science outlines these dimensions and why they matter, and archetypes summarize these same dimensions as stable patterns over weeks.

How this builds credibility: archetypes like sleep_durationsleep_regularitysleep_qualitybed_schedule, and wake_schedule are long-term labels for sleep timing and consistency — the same dimensions used in the Sleep Score scientific model.

2) Activity archetypes map to validated dimensions of physical activity behavior

Physical activity cannot be captured by a single metric like step count. Evidence supports multiple independent dimensions: volume, intensity, frequency, energy expenditure, and sedentary behavior. Sahha’s Activity Score science lays out this multi-dimensional model and its links to outcomes.

How this builds credibility: archetypes like activity_level and exercise_frequency summarize movement behavior over time using these validated dimensions.

Behavioral patterns in sleep regularity, circadian alignment, activity, and sedentary behavior are each associated with emotional balance and resilience. Sahha’s Mental Wellbeing Score science describes a model built from these behavioral dimensions (steps, active hours, extended inactivity, activity regularity, sleep regularity, circadian alignment). Archetypes provide stable “trait-like” versions of these behavioral patterns for segmentation.

Similarly, Sahha’s Wellbeing Score science describes a holistic approach combining sleep and activity factors. Archetypes like overall_wellness provide a stable label aligned to holistic, multi-factor wellbeing.

4) Exercise preference archetypes have direct internal validation for recommendation use

Sahha archetypes include primary_exercisesecondary_exercise, and primary_exercise_typeSahha’s research on archetype-based class matching shows statistically significant evidence that a user’s preferred sports (captured in archetypes) can help predict other sports they may engage with — supporting recommendation experiences built on these archetypes.

5) Scientific references for compliance and transparency

Sahha provides dedicated scientific reference pages for scores (often used for app store submission transparency). These are useful to link in your product for credibility when you explain “why” health signals matter.


Archetype familyWhat it summarizesClosest Sahha science references
ActivityVolume, frequency, intensity, energy expenditure, sedentary behaviorActivity Score science; Activity Score scientific reference
SleepDuration, timing, regularity, quality/continuity patternsSleep Score science; Sleep Score scientific reference
Mental wellnessBehavioral signals linked to emotional balance/resilience (sleep + activity rhythms)Mental Wellbeing Score science
Overall wellnessCombined sleep + activity lifestyle patternsWellbeing Score science
Exercise preferenceStable preference signals from exercise logsArchetype-based class recommendation research; Exercise types taxonomy

List of Archetypes

Below is the current set of archetypes and their possible values.

ArchetypeTypePossible ValuesPeriodicityDescriptionRequires Wearable
activity_levelOrdinalsedentarylightly_activemoderately_activehighly_activeWeekly, MonthlyOverall level of physical activity including movement and exerciseNo
exercise_frequencyOrdinalrare_exerciseroccasional_exerciserregular_exerciserfrequent_exerciserWeekly, MonthlyHow often the individual exercisesNo
mental_wellnessOrdinalpoor_mental_wellnessfair_mental_wellnessgood_mental_wellnessoptimal_mental_wellnessWeekly, MonthlyMental wellness and resiliency based on physical activity, sleep, and stress indicatorsNo
overall_wellnessOrdinalpoor_wellnessfair_wellnessgood_wellnessoptimal_wellnessWeekly, MonthlyOverall wellbeing across all aspects of healthNo
primary_exerciseCategoricalMost frequent exercise (e.g., running, weightlifting, yoga)Weekly, MonthlyMost commonly performed exerciseNo
primary_exercise_typeCategoricalstrength_orientedcardio_orientedmind_body_orientedhybrid_orientedsport_orientedoutdoor_orientedWeekly, MonthlyCategorizes the primary exercise into strength, cardio, sports, etc.No
secondary_exerciseCategoricalSecond most frequent exercise (e.g., swimming, cycling, hiking)Weekly, MonthlySecond most commonly performed exerciseNo
sleep_durationOrdinalvery_short_sleepershort_sleeperaverage_sleeperlong_sleeperWeekly, MonthlyTypical sleep duration relative to recommended normsNo
sleep_efficiencyOrdinalhighly_inefficient_sleeperinefficient_sleeperefficient_sleeperhighly_efficient_sleeperWeekly, MonthlyHow effectively the individual maintains uninterrupted sleepYes
sleep_patternCategoricalconsistent_early_riserinconsistent_early_riserconsistent_late_sleeperinconsistent_late_sleeperearly_morning_sleeperchronic_short_sleeperinconsistent_short_sleeperWeekly, MonthlyOverall sleep behavior based on timing and consistencyNo
sleep_qualityOrdinalpoor_sleep_qualityfair_sleep_qualitygood_sleep_qualityoptimal_sleep_qualityWeekly, MonthlyLong-term quality of sleep based on duration, regularity, recovery, and debtNo
sleep_regularityOrdinalhighly_irregular_sleeperirregular_sleeperregular_sleeperhighly_regular_sleeperWeekly, MonthlyConsistency in sleep timingsNo
bed_scheduleOrdinalvery_early_sleeperearly_sleeperlate_sleepervery_late_sleeperWeekly, MonthlyTypical bedtimeNo
wake_scheduleOrdinalvery_early_riserearly_riserlate_riservery_late_riserWeekly, MonthlyTypical wake-up timeNo