Visual hierarchy
Visual hierarchy is the order in which the eye takes in a screen. When it
matches the importance of the content, the interface reads effortlessly;
when everything shouts equally, the user is lost. The tools are few
(size, weight, color, space, position) and the discipline is restraint.
Method
- Decide the importance order first. Before styling, rank what
matters on this screen: the one primary action, the key information,
the secondary options, the rarely-needed. Design cannot make everything
prominent; deciding what recedes is as important as what stands out.
- Use size and weight for the biggest signals. Larger and bolder
reads as more important; the eye goes there first. A clear type scale
(a few sizes, used consistently) creates hierarchy across headings,
body, and captions (see web-typography, design-systems). Reserve the
largest, boldest treatment for the genuinely most important.
- Use contrast to draw and color to mean. High contrast pulls
attention (the primary button is the boldest thing; secondary actions
recede to outline or text). Give color meaning (one accent for the
primary action, semantic colors for status), and do not spend attention
on decoration (see css-theming, dark-mode). Everything emphasized means
nothing emphasized.
- Let whitespace do the work. Space separates and groups more
powerfully than lines and boxes. Generous space around an element makes
it prominent; tight space binds related things together. Crowded
designs read as cluttered because nothing has room to matter; space is
not wasted, it is structure (see css-layout).
- Group by proximity and alignment. Related things go together and
line up; unrelated things get separated. The eye reads aligned,
grouped elements as organized and scans them fast; scattered,
misaligned ones read as chaos. Consistent alignment is most of what
makes a layout feel designed.
- Guide the scan path. People scan in predictable patterns (top-left
first, F- and Z-shaped for text-heavy and sparse layouts). Place the
most important thing where the eye lands, and sequence the flow down
the priority order. Test by squinting: the blur should still show what
matters most.
Boundaries
- Hierarchy serves the content's real priorities; imposing drama on a
screen where everything is genuinely equal (a data table) is wrong. Not
every screen needs a hero.
- Visual prominence and accessibility differ: contrast for hierarchy must
still meet contrast ratios for legibility, and color must not be the
only signal (see color-contrast, accessibility-review).
- Restraint is the hardest part: the urge to emphasize everything and add
more is what destroys hierarchy. When in doubt, remove and calm down,
do not add (see usability-heuristics' minimalism).
1---2name: visual-hierarchy3description: Guide the eye to what matters through size, contrast, spacing, and grouping so a screen reads at a glance. Use when a design feels cluttered, flat, or hard to scan, or when laying out any interface or page.4---56# Visual hierarchy78Visual hierarchy is the order in which the eye takes in a screen. When it9matches the importance of the content, the interface reads effortlessly;10when everything shouts equally, the user is lost. The tools are few11(size, weight, color, space, position) and the discipline is restraint.1213## Method14151. **Decide the importance order first.** Before styling, rank what16 matters on this screen: the one primary action, the key information,17 the secondary options, the rarely-needed. Design cannot make everything18 prominent; deciding what recedes is as important as what stands out.192. **Use size and weight for the biggest signals.** Larger and bolder20 reads as more important; the eye goes there first. A clear type scale21 (a few sizes, used consistently) creates hierarchy across headings,22 body, and captions (see web-typography, design-systems). Reserve the23 largest, boldest treatment for the genuinely most important.243. **Use contrast to draw and color to mean.** High contrast pulls25 attention (the primary button is the boldest thing; secondary actions26 recede to outline or text). Give color meaning (one accent for the27 primary action, semantic colors for status), and do not spend attention28 on decoration (see css-theming, dark-mode). Everything emphasized means29 nothing emphasized.304. **Let whitespace do the work.** Space separates and groups more31 powerfully than lines and boxes. Generous space around an element makes32 it prominent; tight space binds related things together. Crowded33 designs read as cluttered because nothing has room to matter; space is34 not wasted, it is structure (see css-layout).355. **Group by proximity and alignment.** Related things go together and36 line up; unrelated things get separated. The eye reads aligned,37 grouped elements as organized and scans them fast; scattered,38 misaligned ones read as chaos. Consistent alignment is most of what39 makes a layout feel designed.406. **Guide the scan path.** People scan in predictable patterns (top-left41 first, F- and Z-shaped for text-heavy and sparse layouts). Place the42 most important thing where the eye lands, and sequence the flow down43 the priority order. Test by squinting: the blur should still show what44 matters most.4546## Boundaries4748- Hierarchy serves the content's real priorities; imposing drama on a49 screen where everything is genuinely equal (a data table) is wrong. Not50 every screen needs a hero.51- Visual prominence and accessibility differ: contrast for hierarchy must52 still meet contrast ratios for legibility, and color must not be the53 only signal (see color-contrast, accessibility-review).54- Restraint is the hardest part: the urge to emphasize everything and add55 more is what destroys hierarchy. When in doubt, remove and calm down,56 do not add (see usability-heuristics' minimalism).