Template Variable Syntax
Mark the spots in your template file (docx, pptx, hwpx) where a value should be filled in using the syntax below, and it will be automatically detected as a variable when you upload the file.
Supported syntax
You can use whichever of the following three styles is most convenient for a given template — and you can even mix them within the same file.
| Syntax | Example |
|---|---|
| {VariableName} | {Name}, {ContractDate} |
| {{VariableName}} | {{Name}}, {{ContractDate}} |
| #{VariableName} | #{Name}, #{ContractDate} |
Variable names don't have to be in English or follow any particular naming convention. Free-form text — including spaces — works fine as a variable name. For example, {Quotation Validity Period} (with a space) is recognized correctly.
Marking repeating sections (sub-datasets)
If part of your document repeats — a list of line items, a list of attachments — wrap that section like this:
{#Items}
{ItemName} - {Quantity} - {UnitPrice}
{/}
The closing tag can be written either as {/} (no group name) or {/Items} (repeating the group name) — both are recognized the same way.
A repeating section like this is later linked to a sub-dataset when you use "Generate documents in bulk with a dataset". See Generate Documents in Bulk with a Dataset for how to connect them.
A few things to keep in mind when naming variables
- You don't need to follow any grouping or prefix convention. Variables are listed flat (no grouping), and each one is labeled exactly as you named it.
- If the same variable name appears multiple times in a document (for example, several signature blocks), it's treated as a single variable — enter the value once and it fills every occurrence.
- If you later need to edit the template file itself — adding a variable or renaming one — we recommend using Replacing a Template File instead of uploading a brand-new file. It preserves as much of your existing mappings and saved history as possible.