UNKNOWN_SHAPE
UNKNOWN_SHAPE is a structural warning: a node carries a shape outside the renderer’s known vocabulary and falls back to a plain rectangle, or an architecture service names an icon the renderer cannot resolve and gets a text glyph instead.
What triggers it. Shape syntax the parser modeled but the renderer does not draw — typically newer Mermaid shape names reaching a structured flowchart or state graph — or an architecture icon that is neither built in nor in the bundled icon set.
How to fix it. Switch the node to a supported shape (rectangle, rounded, diamond, stadium, circle, hexagon, cylinder, …) or the service to a supported icon with a source edit; the diagram still renders meanwhile, so this is a warning rather than an error.
Run am verify diagram.mmd --json, inspect this code, and apply the smallest source or typed mutation that clears it. If it persists after two mechanical attempts, return the warning and ask for human review.
In the cloned repo, am is bun run bin/am.ts.
Machine-readable: this page as Markdown.
Back to all warning codes, or open a blank editor to try a fix.