Skip to content

Progressive Disclosure

Reveal information in layers so users receive what they need when they are ready for it.

The Diagnostic Story

Symptom: Everything relevant arrives at once, and nothing is. Novices freeze at the full wall of detail; experts wade through clutter to find what they need; critical warnings share space with optional preferences; and the important part gets skimmed because it is not visibly more important than anything else.

Pivot: Divide the information into layers matched to the user's current task, readiness, and risk context. The first layer must be usable and safe on its own; every deeper layer sits behind a legible reveal trigger that preserves orientation between levels.

Resolution: Cognitive load drops at entry without hiding the depth that experts and exception-handlers need. Users complete the common case from the first layer and locate the supporting detail when they actually need it, with critical warnings always surfaced rather than buried.

Reach for this when you hear…

[onboarding design] “We gave new hires the full policy manual on day one and then wondered why they kept making basic errors they should have avoided if they had actually read it.”

[medical device UI] “The alert for the dangerous setting sits right next to the alert for low battery, and the nurses have learned to dismiss both without reading either.”

[API documentation] “I can get a developer started in ten minutes if I show them the quick-start first, but if I open with the full reference spec they close the tab and ask someone in Slack.”

Mechanisms / Implementations

  • Advanced Settings Panel
  • Drill-Down Dashboard
  • Expandable Section
  • Just-in-Time Help
  • Layered Documentation
  • Progressive Training Module
  • Staged Onboarding
  • Summary-Detail View
  • Tiered Decision Support
  • Wizard or Stepper Workflow

Abstractions this archetype builds on — directly (a source ingredient) or as a related pattern. Links follow the typed catalog namespace.

Built directly on (3)

Also references 8 related abstractions

Variants

Narrower or domain-specific specializations that share this archetype's core structure. Recognized variants are established; candidate variants are provisional.

Task-Stage Disclosure · use context variant · recognized

Reveals information according to where the user is in a workflow, learning path, service journey, or decision sequence.

Expertise-Adaptive Disclosure · use context variant · recognized

Adjusts the amount and kind of information shown according to a user’s skill, role, confidence, or demonstrated readiness.

Risk or Exception Disclosure · risk or failure variant · recognized

Keeps ordinary guidance simple while surfacing warnings, constraints, exceptions, or escalation detail when risk conditions become relevant.

Drill-Down Disclosure · implementation variant · recognized

Starts from an overview or aggregate layer and lets users navigate downward into progressively more specific detail.