Error codes¶
Validation and parse errors carry numbered codes (e.g. [E202]). Look up any code's cause, example, and fix below — or from the CLI with scrolly errors <code>.
| Code | Summary |
|---|---|
| E001 | JSON5 syntax error |
| E002 | File must be a JSON object |
| E003 | Missing required field |
| E004 | Field type mismatch (string expected) |
| E005 | Field type mismatch (list expected) |
| E006 | Field type mismatch (object expected) |
| E007 | Array has wrong number of elements |
| E008 | Position entries must be integers |
| E009 | Hex color format invalid |
| E010 | Nested groups not allowed |
| E011 | Endpoint string malformed |
| E012 | Both inline and *_file forms specified |
| E101 | Duplicate slide id |
| E102 | Two slides at same grid position |
| E103 | Duplicate group label, edge, or group membership |
| E201 | At least one element required |
| E202 | font_scale must be > 0 |
| E203 | initial_scroll_position must be >= 0 |
| E204 | scroll_range must be >= 0 or "auto" |
| E205 | initial_scroll_position exceeds scroll_range |
| E206 | snap_positions value out of range |
| E207 | Duplicate element name |
| E208 | Template-slide stub invalid |
| E299 | Pydantic schema violation in slide source |
| E301 | Both width and height are "auto" |
| E302 | Numeric width or height must be > 0 |
| E303 | object_fit is required when both dimensions are numeric |
| E304 | object_fit is forbidden when a dimension is "auto" |
| E305 | image_sequence needs at least 2 entries |
| E306 | image_sequence timing constraint violated |
| E307 | Iframe border_width or shadow_size must be >= 0 |
| E308 | Animated keyframes invalid |
| E309 | Container dimension is "auto" |
| E310 | Container has no children |
| E311 | Template element form invalid |
| E401 | Asset file does not exist |
| E402 | Invalid or duplicate asset filename |
| E403 | Unsupported image format |
| E501 | Edge references unknown slide |
| E502 | Group references unknown slide |
| E503 | Cannot infer edge side (slides not on same row or column) |
| E504 | Slide source filename has unknown suffix |
| E505 | Slide source file not found |
| E506 | File reference escapes the deck root |
| E507 | Include cycle detected |
| E601 | No element compiler or renderer registered |
| E602 | Element conversion cycle detected |
| E603 | No renderer for slide IR |
| E701 | Output path is not a directory |
| E702 | Output directory not empty |
| E703 | Invalid output file name |
| E801 | Template syntax error |
| E802 | Undefined template variable |
| E803 | Rendered template output invalid |
| E804 | Template parameter mismatch |
| E805 | Template render failed |
| E806 | Template suffix mismatch |