references/diagrams/quadrant.md
Quadrant Chart
Back to Style Guide — Read the style guide first for emoji, color, and accessibility rules.
Syntax keyword: quadrantChart
Best for: Prioritization matrices, risk assessment, two-axis comparisons, effort/impact analysis
When NOT to use: Time-based data (use Gantt or XY Chart), simple rankings (use a table)
Accessibility: Mermaid 12.0.0 emits
accTitle/accDescrfor this type. Keep a visible description and verify older destination renderers.
Exemplar Diagram
Priority matrix plotting engineering initiatives by effort required versus business impact, helping teams decide what to build next:
quadrantChart
accTitle: Quadrant Example
accDescr: Illustrative quadrant diagram; the surrounding text describes its data and relationships.
title 🎯 Engineering Priority Matrix
x-axis Low Effort --> High Effort
y-axis Low Impact --> High Impact
quadrant-1 Plan Carefully
quadrant-2 Quick Wins
quadrant-3 Low Priority
quadrant-4 Reconsider
Upgrade auth library: [0.3, 0.9]
Migrate to new DB: [0.9, 0.8]
Fix typos in docs: [0.1, 0.2]
Add dark mode: [0.4, 0.6]
Rewrite legacy API: [0.95, 0.95]
Update CI cache: [0.15, 0.35]
Add unit tests: [0.5, 0.7]
Tips
- Label axes with
Low X --> High Xformat - Name all four quadrants with actionable labels
- Plot items as
Name: [x, y]with values 0.0–1.0 - Limit to 5–10 items — more becomes cluttered
- Quadrant numbering: 1=top-right, 2=top-left, 3=bottom-left, 4=bottom-right
- Always pair with a Markdown text description above for screen readers
Template
Description of the two axes and what the quadrant placement means:
quadrantChart
accTitle: Quadrant Example
accDescr: Illustrative quadrant diagram; the surrounding text describes its data and relationships.
title 🎯 Your Matrix Title
x-axis Low X Axis --> High X Axis
y-axis Low Y Axis --> High Y Axis
quadrant-1 High Both
quadrant-2 High Y Only
quadrant-3 Low Both
quadrant-4 High X Only
Item A: [0.3, 0.8]
Item B: [0.7, 0.6]
Item C: [0.2, 0.3]
Verified reference
Syntax examples reviewed against official Mermaid documentation and rendered with Mermaid 12.0.0 (2026-10-01). Check the destination version; appearance and accessibility are not guaranteed by a successful parse.