Config Layer Parse Failure
Q-1-23 — Config Layer Parse Failure
A configuration layer could not be validated as a coherent YAML configuration.
What this means
Quarto loads configuration from several sources — _quarto.yml,
profile files, project metadata, document front-matter — and
merges them layer by layer. Each layer is validated for structural
soundness before being merged in. This error fires when one of
the layers fails that structural check.
The error message includes both the underlying problem (forwarded from the structural validator) and a location pointing at the configuration file in question, so you can identify which layer failed.
Why this happens
The error is the wrapper Quarto attaches to whatever the layer validator complains about. Common underlying causes:
- A tag-related error inside the layer — for example
Q-1-24(empty tag component),Q-1-26(invalid tag character), orQ-1-28(conflicting merge operations). The layer is otherwise well-formed YAML, but a tag inside it is malformed. - A structural inconsistency the merger cannot reconcile, for example a value that should be a map appearing as a scalar in one layer.
How to fix
Read the error message’s “Failed to validate config layer:” detail
to see the underlying problem, then jump to the file and location
that the location field points to. The fix is whatever the
underlying error needs — Q-1-23 itself is just the contextual
wrapper.
If the underlying error is one of the tag errors, see the page for the specific code in the message.