Tag syntax

Templates use double-brace tags with dotted paths — the same syntax as Handlebars / Mustache / docx-templates. The renderer walks the path against the request body and substitutes the value.

Basic substitution

HTML
<dd>{{subject.given_names}} {{subject.surname}}</dd>
<!-- renders as: -->
<dd>Alexandra Elise Marković-Langley</dd>

Conditional rendering

Skip a block entirely when a field is null — useful for optional sections like a second adopter, witnesses, or the mother's maiden name:

Handlebars
{{#if mother.maiden_name}}
  <span class="italic">(maiden: {{mother.maiden_name}})</span>
{{/if}}

Iteration

For arrays like witnesses or additional legs on a travel registration:

Handlebars
{{#each witnesses}}
  <dt>Witness {{@index}}</dt>
  <dd>{{this.name}} of {{this.residence}}</dd>
{{/each}}

Required vs optional

Fields marked with a red req badge throw MissingRequiredFieldError if the request body doesn't supply them. Optional fields render as an em-dash — if missing, or you can wrap them in {{#if}} to skip entirely.

Special markers