← All chart types

bar family

bar-stacked-vertical

Vertical bars where each bar is segmented into stacked components.

Each total is the sum of its parts; segments encode subcategories within each bar. Strong when both the total AND its composition matter. Weak when readers need to compare individual segment sizes — only the bottom segment shares a baseline.

When to use

Showing how a total breaks down across the same subcategories over time or across cases. Think revenue mix, age distribution per cohort.

When NOT to use

You only care about composition and not totals (use 100% stacked or pie). The top segments need precise comparison (use grouped bars).

Rhetorical roles

  • compare
  • evolve
  • decompose

Variants & related

Required primitives

  • has_legend
  • has_axis_titles

Optional primitives

  • has_data_labels
  • has_title
  • has_source_note

Common anti-patterns

  • rainbow-palette
  • too-many-segments
  • truncated-axis

Disambiguation rules

  • Each bar is a single column with multiple coloured segments stacked top-to-bottom.
  • If the bar tops all reach 100%, that is bar-stacked-100pct (encode as bar-stacked-vertical with note).
  • If a line overlays the bars (e.g. growth rate), set canonical_type_secondary=line.