Skip to main content

Error reference

One page per error code emitted by Quarto. Pages explain what each error means, why it typically fires, and how to fix it.

This page lists every error code Quarto can emit, with a link to the per-code reference page. Use the filter above to narrow by subsystem or status.

The catalog of codes lives in crates/quarto-error-catalog/error_catalog.json. The pages here are the prose layer over that catalog: where the catalog says which codes exist, the pages explain them.

Status legend

Status Meaning
complete Canonical reference. Has met the prose-quality bar described in the README.
stub A human has reviewed and lightly filled out the page. Not yet a finished reference.
draft Page exists with auto-generated placeholder body. No human prose yet.
deprecated Newer Quarto versions no longer emit this code, but the page stays live so users on older versions can still look it up.

See docs/errors/README.md on GitHub for the full authoring conventions.

Code Title Subsystem Status
Internal Error
Generic Error
YAML Syntax Error
Missing Required Property
Type Mismatch
Invalid Enum Value
Array Length Constraint Violation
String Pattern Mismatch
Number Range Violation
Object Property Count Violation
Unresolved Schema Reference
Unknown Property
Array Uniqueness Violation
Failed to parse metadata value as markdown
Unknown Tag Component
Unrecognized Tag
Config Layer Parse Failure
Empty Tag Component
Whitespace in Tag
Invalid Tag Character
Config Nesting Too Deep
Conflicting Merge Operations
String Length Constraint Violation
Generic Validation Error
Template Parse Error
Undefined Variable
Partial Not Found
Recursive Partial
Unresolved Partial Reference
Unknown Pipe
Invalid Pipe Arguments
Lua Filter Diagnostic
SimpleTable is not supported
Invalid Lua argument
Invalid Lua filter return value
Invalid Lua property assignment
Invalid Lua filter script return value
Unrecognized Lua filter handler name
Custom Listing Template Not Yet Supported
Listing Markdown Re-parse Diagnostics
Mixed Category Modes On One Page
Categories Enabled But No Item Has Any
Listing Item Produced No Preview Content
Listing Type custom Without template Path
Listing Feed Skipped: Missing site-url
Listing Feed: Sibling Output Unreadable
Listing Contents Pattern Outside Project
Invalid Glob Pattern in Listing contents:
Listing contents: Pattern Matched Nothing
Inline Listing Contents Not Yet Supported (retired)
Listing Record Path Names No Document
Listing Record Has No Title
Listing Record Key Looks Misspelled
YAML-File Listing Contents Not Yet Supported
Custom Listing Template Is Not a Doctemplate
Listing Id Collides With Section Id (retired)
Listing Item Prose Has More Than One Paragraph
Unknown Sort Field
Listing Id Collision
Invalid field-display-names Value
listing: false Not Allowed
template Requires type: custom
Listing Template File Missing
Quarto 1 EJS Listing Template Extension
Sidebar references missing document
Sidebar entry has both section: and text:
Repository actions require a repo-url
Unknown repository action
Page-level repo-actions: true ignored
Invalid link-external-filter
Announcement references missing document
Announcement has no content
Invalid announcement option
Navbar references missing document
Page footer references missing document
Body link references missing document
Sidebar auto: ignored
Sidebar auto: matched no documents
Page navigation references missing document
Unsupported toc-location value
link-format request cannot be honored
Invalid theme configuration
Two brand font files publish under the same name
Unsupported key on a brand font file entry
Unknown theme name
Theme file not found
Unknown highlight style
Theme SCSS compilation failed
Theme file has no layer boundary markers
Invalid brand font weight
Brand font file not found
Duplicate Crossref Identifier
Duplicate Crossref Identifier Across Chapters
Extension not loaded
Engine extension does not declare static claims
Engine resolution deferred to render time
Engine failed to load while answering a claim
Shortcode script load failure
Unknown shortcode
Shortcode handler shadowed
Shortcode value not found
Block shortcode in inline position
Invalid project type contribution
Ambiguous project type extension
Project type contribution missing base type
Circular Include
Include File Not Found
Include File Parse Error
Include Not Expanded Here
Engine Returned an Unreadable Result
Engine Include File Could Not Be Read
Engine Runtime Not Found
Plot Document Not Found
Invalid Plot Document
Plot Rendered With Warnings
Brand Color Not Applied To Plot
Unclosed Span
Closing Quote Without Matching Open Quote
Unclosed Double Quote
Unclosed Star Emphasis
Unclosed Strong Star Emphasis
Unclosed Underscore Emphasis
Unclosed Strong Underscore Emphasis
Unclosed Superscript
Unclosed Subscript
Unclosed Strikeout
Unclosed Editorial Insert
Mismatched Delimiter in Attribute Specifier
Unclosed Editorial Delete
Unclosed Editorial Comment
Unclosed Editorial Highlight
Unclosed Inline Math
Unclosed Code Span
Unclosed Image
Unclosed Inline Footnote
Line Break Before Shortcode Close
Line Break Before Escaped Shortcode Close
Indented Footnote Content Not Supported
Key-value Pair Before Class Specifier in Attribute
Multi-Paragraph Footnote Indentation Not Supported
Inline Code Execution Not Allowed in URLs
Triple Star Emphasis Not Allowed
Spaces in Link Targets
Unquoted Shortcode Parameter Starting with Digit
Invalid List-Table Structure
Old-style knitr chunk options are not supported
Line break in link destination
Unclosed Attribute Specifier
Grid tables are not supported
Missing Space After Div Fence
Engine Specification Ignored for Markdown Input
Curly braces are reserved for attribute syntax
Invalid conditional content attribute
Callout title given twice
Callout title is not inline content
Reference-style links are not supported
Link reference definitions are not supported
Cell option ignored on a diagram cell
Wrong cell-option marker for a diagram cell
Bracketed text renders without its brackets
Unclosed Emphasis
Doubled curly braces are not supported
Engine claim on a Quarto-owned file type ignored
Shortcode delimiter not separated by a space
Fenced div info string starts with -
Pandoc definition lists are not supported
Class Specifier Before Identifier in Attribute
Key-value Pair Before Identifier in Attribute
Invalid fig-align value on a diagram cell
HTML Element Found in Document
Unclosed Single Quote
Unsupported Code Block Syntax
HTML Element Auto-converted
Pandoc Not Found
Pandoc Version Too Old
Pandoc Exited With An Error
Filter Params Blob Too Large
Unrecognized Custom Node Type
Callout Has No Registered Crossref Category
Theorem Has No Registered Theorem Type For Its Identifier
Multiple Formats in One Render Not Yet Supported
Remote Image Could Not Be Fetched for Typst in the Browser
Typst Not Found
Typst Version Too Old
Typst Compile Failed
Brand Font Not Available To Typst
Unknown Math Command
Ragged Rows In Math Environment
Limits Command Ignored
Math Construct Dropped
Math Syntax Error
Unknown Math Environment
Mismatched Math Environment
Math Command Missing An Argument
Unbalanced Brace In Math
Unbalanced Left And Right Delimiters
Double Subscript Or Superscript
Math Macro Expansion Limit Exceeded
Unsupported Math Command
Citeproc Resolves After Book Merge Point
Unsupported Import File Type
Images Converted
Image Format Not Displayable
Internal Import Error
The Converter Failed on This File
Unmatched Comment Markers
Import File Too Large
The Converter Couldn’t Read the File
Warning From the Document Reader
Comment Ranges Simplified
Paragraph-Mark Changes Dropped
List Number Styles Lost
Image Skipped
Image Conversion Failed
Invalid components entry
Component module outside the project
npm component sources are not supported yet
Component binds to no element
Element bound by two components
Invalid component option value
Unknown component name on element
component-props is not a JSON object
Component module could not be prepared
Lua syntax error in an lmd cell
Unsupported markdown inside an lmd fragment
Inline fragment holds more than one block
lmd cell failed
lmd cell did not return blocks
Inline lmd cell did not produce inlines
Invalid lmd cell options
lmd module did not compile
lmd autoload failed
IO Error During Write
Inline Note Definition Not Supported
Fenced Note Definition Not Supported
Unresolved Note Reference
Block Metadata Not Supported
Caption Block Not Supported
Shortcode Not Supported
Unprocessed Note Reference
Standalone Attribute Not Supported
Unprocessed Insert Markup
Unprocessed Delete Markup
Unprocessed Highlight Markup
Unprocessed EditComment Markup
JSON Serialization Failed
Invalid Metadata Structure
Shortcode edit dropped
Generated content edit dropped
LineBlock Not Supported in ANSI Format
CodeBlock Not Supported in ANSI Format
Table Not Supported in ANSI Format
Figure Not Supported in ANSI Format
NoteDefinitionPara Not Supported in ANSI Format
NoteDefinitionFencedBlock Not Supported in ANSI Format
Resource Path Resolves Outside the Project Root
Project render script could not be launched
Unknown project key (underscore spelling)
Project render scripts unsupported in this environment
project.render Pattern Matched No Files
project.render Pattern Outside the Project Root
Invalid Glob Pattern in project.render
resources: Pattern Matched No Files
Unknown project type
Project type not yet implemented
Unknown project profile
Invalid Glob Pattern in resources:
Invalid profile configuration
Invalid profile name
Profile key has no effect here
Alias Would Overwrite a Rendered Page
Two Pages Claim the Same Alias
Alias Paths Differ Only by Case
Alias Resolves Outside the Output Directory
Invalid diagnostics: entry
llms-txt Would Overwrite an Existing File
Declared Stylesheet Not Found
Failed Walking Glob Matches for resources:
Pandoc Path Option Not Found
Nested Projects Skipped
Render Pattern Reaches Into Nested Project
Format Not Supported by Book Projects
Book Parts Cannot Be Nested
Book Chapter File Not Found
Book Has No Home Page
Brand File Not Referenced
Unknown website.search Option
Invalid website.search Value
Example Embed Missing file=
Algolia Search Is Misconfigured
Page Is Not a Chapter of the Book
Book Scope Does Not Apply to This Format
Invalid book-scope Value
book-scope Is Not a Format Option
book-scope chapter Ignored for a Whole-Book Render
book-scope Only Applies to Books
book-scope chapter Needs a File
Book Requested for a Page Outside the Book
Invalid draft-mode Value
Example Embed Target Is Not a Static Asset
Invalid drafts Pattern
Referenced Resource Not Found
Resource Copy Failed
Project render script failed
Pre-render script changed a forbidden project setting
Missing Newline at End of File
Input Path Not Found
No Input and No Project
Multiple Inputs Without a Project
Inputs Span Multiple Projects
Input Excluded From Render List
No Renderable Files Matched
Project Discovery Failed
XML Syntax Error
Unexpected Element
Missing Text Source
Undefined Macro
Circular Macro Dependency
Duplicate Macro Definition
Invalid CSL Version
Invalid Root Element
Unexpected End of XML Input
Mismatched XML End Tag
Invalid XML Structure
Empty XML Document
Multiple XML Root Elements
Missing Required Attribute
Invalid Attribute Value
Missing Required Element

No matching items