Basic quadrant chart example
quadrantChart
title Feature prioritisation
x-axis Low effort --> High effort
y-axis Low impact --> High impact
quadrant-1 Plan carefully
quadrant-2 Do first
quadrant-3 Maybe later
quadrant-4 Avoid
Dark mode: [0.2, 0.55]
AI generator: [0.7, 0.9]
SSO: [0.8, 0.6]
Keyboard shortcuts: [0.15, 0.7]
Custom fonts: [0.6, 0.2]Quadrant charts place items on two axes split into four quadrants — the classic 2×2 matrix. They're used for effort/impact prioritisation, competitor positioning, risk matrices and the Eisenhower urgent/important grid.
In Mermaid you name the axes and quadrants, then list points with x and y values between 0 and 1.
When to use a quadrant chart
- Effort vs impact prioritisation
- Competitive landscape maps
- Risk likelihood vs severity
- Eisenhower matrices
Quadrant Chart syntax reference
| Syntax | What it does |
|---|---|
quadrantChart | Start a quadrant chart. |
x-axis Left --> Right | Label both ends of the x-axis. |
y-axis Bottom --> Top | Label both ends of the y-axis. |
quadrant-1 … quadrant-4 | Labels: 1 top-right, 2 top-left, 3 bottom-left, 4 bottom-right. |
Point: [x, y] | Plot a point; x and y range from 0 to 1. |
Quadrant Chart examples
Eisenhower matrix
Urgent vs important tasks.
quadrantChart
title Eisenhower matrix
x-axis Not urgent --> Urgent
y-axis Not important --> Important
quadrant-1 Do now
quadrant-2 Schedule
quadrant-3 Drop
quadrant-4 Delegate
Tax return: [0.85, 0.9]
Exercise: [0.2, 0.8]
Most emails: [0.75, 0.25]
Social media: [0.1, 0.1]Two scores, and a place on a square, are the whole chart. A mermaid quadrant chart plots items from 0 to 1 on each axis and names the four boxes. It's the picture for "how valuable, how urgent" when you have a handful of bets. It collapses as soon as you need a third axis.
Axes, quadrants, and the numbers
x-axis Low --> High runs from the left edge to the right edge. y-axis Low --> High runs from the bottom to the top. Both scales are 0 to 1, even when your real scores were 1 to 5. Divide by the max, or pick a position by eye, and accept that 0.5 is the midline.
The quadrant numbers are fixed. Quadrant-1 is the top right, high on both axes. Quadrant-2 is the top left. Quadrant-3 is the bottom left. Quadrant-4 is the bottom right. Naming quadrant-1 "low priority" will confuse everyone who can see that the box is the high-high corner. Name the box for the decision you want there: do it, talk first, skip, fill in later.
Each item is Search: [0.8, 0.7]. The first number is x and the second is y. A value outside 0 to 1, such as [1.4, 0.2], fails the parse. If your spreadsheet has a 14, scale it before it touches the diagram.
Keep the set small. Labels sit on the dots. Ten items in one corner become a pile of text, and the quadrant name does the job better than the pile.
Worked example
Two bets. Search is strong on both axes. Docs are weaker on the horizontal axis and still fairly high on the vertical one.
quadrantChart
title Bets
x-axis Low --> High
y-axis Low --> High
quadrant-1 Do now
quadrant-2 Talk first
quadrant-3 Skip
quadrant-4 Fill in
Search: [0.8, 0.7]
Docs: [0.3, 0.6]Say the axes out loud in the doc, because the chart only has room for "Low" and "High". Here x is reach and y is confidence. Search at 0.8 reach and 0.7 confidence lands in quadrant-1, the do-now box. Docs at 0.3 reach and 0.6 confidence lands in quadrant-2, the top left, where the label says to talk before you build. If confidence were 0.2, Docs would fall into quadrant-3 and the advice would be to skip it.
The numbers are judgments. 0.8 isn't a measurement unless you say what data you divided. The chart is still useful. It makes the disagreement specific. Someone who thinks Docs has more reach edits one number, and the dot moves. That's a better meeting than a list of opinions with no coordinates. Write the axis meanings in the caption, in the same direction as Low --> High, so a reader who only sees the PNG still knows that right means more reach.
When this is the wrong diagram
A radar chart is the better picture when each item has three or more scores, such as speed, care, and cost. An XY chart is the better picture when the horizontal axis is time and you want bars. Use a quadrant chart when two axes and four decisions are actually the framework you use.
Common mistakes
- A coordinate outside 0 to 1, such as
[1.4, 0.2]. The parser rejects it. Scale the source number onto the unit square first. - Calling quadrant-1 the bottom-left box. Quadrant-1 is the top right, where both axes are high.
- Axis captions that hide which end is high.
Low --> Highis the direction. A title like "Score" on both axes leaves the dots unexplained. - Plotting every idea in the backlog. The labels cover the square. Keep the items you're actually choosing between.
Where to go next
The AI quadrant generator will place a short list if you describe the two axes. Nudge the points in the editor, and the cheat sheet has the axis lines. The feature priority template is the same chart with a product backlog instead of two bets.
The axes are the decision
A quadrant chart is useless when both axes say "good" and "bad" in different words. Name the x-axis and the y-axis with the tradeoff you are actually making: impact against effort, or risk against value. Points that all land in one quadrant mean the scale is wrong or the decision is already made. Move the scale or drop the chart.
Keep point labels short enough to sit next to the dot. A sentence belongs in the paragraph under the figure. The feature prioritization template is a worked example with real axis names.
Put the point that the meeting will argue about closest to a corner, and name it with the feature, not with a number.
Tips and best practices
- Remember the quadrant numbering starts top-right and goes counter-clockwise.
- Keep point labels short; long labels overlap.
- Values must be between 0 and 1 — normalise your data first.
Generate a quadrant chart with AI
Not sure where to start? Describe what you need and the AI quadrant chart generator writes the Mermaid code for you. Try prompts like:
- “Competitor analysis of note-taking apps by price and features”
- “Risk matrix for a software launch”
- “Marketing channels by cost and reach”
Quadrant Chart templates
Quadrant Chart FAQ
Which quadrant is quadrant-1 in Mermaid?
quadrant-1 is top-right, quadrant-2 top-left, quadrant-3 bottom-left and quadrant-4 bottom-right.
What range do point coordinates use?
Both x and y must be between 0 and 1, where 0 is the left/bottom and 1 the right/top of the chart.