Unit 06 · lesson

Liquid Failures

Liquid failures live inside the rendering/template layer.

But not every Liquid mistake crashes the build.

Syntax failure

A malformed tag can produce a build error.

Example family:

{% if page.featured %}
...

without the expected closure.

Missing data

A valid object reference with the wrong key may render blank:

{{ page.descripton }}

No parser explosion required.

Wrong scope

{{ site.title }}

when you expected page.title.

Valid expression.

Wrong owner.

Wrong filter assumption

Using a filter that does not exist or applying one to an unexpected value can fail or produce surprising output depending on the situation.

Check the supported upstream filter reference for your Jekyll/Liquid version.

Diagnosis sequence

Did Liquid syntax parse?
  ↓ yes
Did the referenced scope/key exist?
  ↓ yes
Did filter/condition produce expected value?
  ↓ yes
Did generated HTML contain expected output?

Lab

Create one syntax failure and one valid-but-wrong-data failure.

Repair both.

Checkpoint

Write why a green "build completed" message cannot prove every Liquid variable resolved correctly.