Glossary
Variable substitution
Variable substitution replaces placeholders in a template with values from a record, row, or API payload.
Variable substitution is the moment a placeholder becomes real document content. A template might contain a marker such as customer_name, invoice_total, start_date, or signer_title. During rendering, the document system looks up the matching value in the current row or payload and inserts it into the output. The concept is simple, but the surrounding discipline determines whether generated documents are trustworthy.
Good substitution starts with clear names and a stable data contract. Template authors should know which variables are required, which are optional, and how missing values should appear during preview. Operators should avoid changing CSV headers without updating the template, and they should test values that stretch layout boundaries, such as long names or unusual currency amounts. More advanced workflows combine substitution with filters, conditional sections, and repeated blocks, but the foundation stays the same: every placeholder must point to a value the workflow can explain.
Questions, answered
- What happens if a variable is missing?
- A good workflow should make missing values obvious in preview or validation instead of silently producing a polished but incomplete document.