Managing Templates

Templates define how your documents look. They are version-controlled and support powerful logic.

Template Types

Standard web technologies. Use HTML for most documents and reports. Use SVG for labels where precision and scaling are critical.

For SVG templates, Thoth includes an integrated Draw.io editor.

Set the Template Type to HTML, SVG, Draw.io.
Click Open Editor.
Design your label visually.
Use the Text tool to add placeholders like {{ barcode }}.
When you save, the SVG source is automatically updated and "cleaned" to be compatible with the rendering engine.

Thoth uses a syntax inspired by Jinja.

Inject data using double curly braces:

<div>Customer: {{ customer_name }}</div>

Show or hide content based on data:

{% if priority == 'high' %}
  <span style="color: red;">URGENT</span>
{% endif %}

Iterate over lists:

<ul>
{% for item in line_items %}
  <li>{{ item.name }} - {{ item.quantity }}</li>
{% endfor %}
</ul>

Transform data on the fly:

<div>Total: {{ total_price | currency('USD') }}</div>
<div>Date: {{ created_at | date('YYYY-MM-DD') }}</div>

Templates follow a Draft/Published workflow.

Draft: Any change you save creates a new state in the current draft.
Publishing: Clicking Publish takes the current draft and creates a permanent, immutable Version.
Stability: Renderers use the latest Published version by default. This ensures that editing a template doesn't break production documents until you are ready.
Rollback: You can view the History tab and click Restore on any previous version to bring its content back into the current draft.

When you save a template, Thoth parses the source code to find all {{ variable }} tags. These detected variables are then used: