Example
quadrantChart
title Feature Priority Matrix
x-axis Low Effort --> High Effort
y-axis Low Impact --> High Impact
quadrant-1 Quick wins
quadrant-2 Major projects
quadrant-3 Fill-ins
quadrant-4 Thankless tasks
Syntax highlight: [0.2, 0.8]
Layout sliders: [0.3, 0.7]
Pan & Zoom: [0.4, 0.75]
Error line marker: [0.3, 0.85]
AI generation: [0.85, 0.9]
Dark mode: [0.25, 0.4] Syntax
Axes, quadrants, points
quadrantChart
title Roadmap candidates
x-axis Low effort --> High effort
y-axis Low impact --> High impact
quadrant-1 Do next
quadrant-2 Plan carefully
quadrant-3 Maybe later
quadrant-4 Avoid
Dark mode: [0.2, 0.6]
Offline sync: [0.8, 0.9]
New icon set: [0.3, 0.2] Quadrant numbering: 1 top-right, 2 top-left, 3 bottom-left, 4 bottom-right. [x, y] with 0,0 at the bottom-left.
Point styling
quadrantChart
x-axis Low --> High
y-axis Low --> High
Critical bug: [0.9, 0.95] radius: 8, color: #dc2626
Nice to have: [0.2, 0.3] radius: 4 Per-point radius, color, stroke-color, and stroke-width are supported in Mermaid 11.
Common mistakes
These are the parse errors that come up most, including in code written by ChatGPT and Claude. Paste any failing diagram into the editor and it marks the offending line.
-
Coordinates outside 0 to 1 (
[3, 7]).Fix: Scale to the unit square. Points beyond 1 are clipped.
-
Axis label without the arrow (
x-axis Effort).Fix: Both ends are optional, but the arrow is what separates them:
x-axis Low --> High. A single label without an arrow also parses. -
Point names containing a colon.
Fix: The colon starts the coordinates. Rephrase the name.
Real-world examples
Complete, copy-ready quadrants for common situations. Each one opens in the editor with a click.
-
Feature Prioritization Quadrant Chart (Effort vs Impact)
A Mermaid quadrant chart plotting seven backlog items by effort and impact, with quadrants labeled Do first, Plan carefully, Reconsider, and Avoid.
-
Project Risk Matrix Quadrant Chart (Likelihood vs Impact)
A Mermaid quadrant chart plotting seven project risks by likelihood and impact, with quadrants labeled Mitigate now, Prepare a plan, Accept, and Monitor.
FAQ
Can I have more than four quadrants?
No. For a 3x3 grid use an XY chart with reference lines drawn as extra series, or a block diagram.
Is the quadrant chart good for a competitive landscape?
Yes, it is the classic use. Name the axes after the two dimensions buyers care about and plot each competitor as a point.