Label Template Tool — Reference

How to use the tool and the Handlebars template language with custom helpers.

Tool Usage

Authentication

Paste a valid bearer token into the token field in the toolbar and click Set Token. The token is stored in your browser's session and used for all API calls (load, save, delete, preview).

Three-Pane Layout

Template Management

• Load — Filter by Retailer ID and/or Spec Type, then select from the dropdown.
• Save — Overwrites the currently loaded template.
• Save As — Creates a new template (prompts for name, retailer, spec type).
• New — Clears the editor for a fresh template.
• Delete — Permanently removes the selected template.
• Format — Auto-formats the template HTML.

Partials

Click Partials in the toolbar to manage reusable template fragments. Create named partials and reference them in your template with {{> partial-name}}. Partials are saved per-template.

Drag & Drop

Drop a .json file onto the Source Data pane to load it instantly.

Template Syntax (Handlebars)

Expressions

Conditionals

{{#if DisplayOnPack}}
  <p>{{Value}}</p>
{{/if}}

{{#if (equals Status "active")}}
  <span>Active</span>
{{else}}
  <span>Inactive</span>
{{/if}}

Iteration

{{#each Nutrients}}
  <tr>
    <td>{{Nutrient.Name}}</td>
    <td>{{RoundedValueString}} {{UnitOfMeasure.Abbreviation}}</td>
  </tr>
{{/each}}

Context Access

With Block (Scope Narrowing)

{{#with Chapters.Labeling.ProductInformationSection}}
  <h2>{{CommercialName.CommercialName}}</h2>
  <p>{{LegalName.LegalName}}</p>
{{/with}}

Custom Helpers

equals

Compares two values for strict (case-sensitive) equality. Use inside {{#if}} blocks.

{{#if (equals Status "active")}}Active{{/if}}

• Case-sensitive, exact string comparison.
• Returns a boolean for use with {{#if}}.

contains

Checks whether a string contains a substring.

{{#if (contains IngredientList "milk")}}
  <span class="allergen">Contains milk</span>
{{/if}}

• Case-sensitive.
• Returns false if the value is null or empty.

replace

Replaces all occurrences of a substring.

{{replace ProductCode "-" ""}}

• Three arguments: source, find, replacement.
• Case-sensitive. Replaces all occurrences.
• Returns empty string if source is null.

join

Concatenates a collection into a single string with a separator.

{{join AllergenNames ", "}}

• First argument must be an array/collection.
• Produces empty string for empty collections.

nutriscore-img

Renders the full Nutri-Score SVG for a grade (A–E).

{{{nutriscore-img NutriscoreGrade}}}

• Valid grades: A, B, C, D, E (case-insensitive).
• Returns empty string for null or unrecognised grades.

dms-img

Renders an inline <img> tag for a file stored in the Document Management System (DMS). The engine pre-fetches referenced files as base64 data URIs before template execution — no browser authentication is needed to display the images.

{{{dms-img Claim.Logo.FileId}}}

{{! With alt text }}
{{{dms-img Claim.Logo.FileId Claim.ClaimName}}}

• Output: <img src="data:image/png;base64,..." alt="Organic" />
• Returns empty string if the file ID is null, not a valid GUID, or the download failed.
• The engine only fetches files when the template contains dms-img (performance optimisation).

lowercase

Converts a string value to lowercase.

{{lowercase UnitOfMeasure.Name}}

• Returns empty string if the value is null or no argument is provided.

uppercase

Converts a string value to uppercase.

{{uppercase Nutrient.Name}}

• Returns empty string if the value is null or no argument is provided.

t (translate)

Looks up a translation key from a language file. Language files are separate embedded JSON resources (e.g. Food.en-US.json) stored alongside the template.

{{t "composition"}}

• Language is selected automatically based on the language query parameter when rendering via the generate/default endpoints.
• Supported default-template languages: en-US, nl-BE, fr-FR, de-DE, it-IT, pt-PT, es-ES.
• Fallback: renders [key] if the key is not found.
• Returns empty string if key argument is null.

Language File Format

Each language file is a flat key-value JSON file named {TemplateName}.{locale}.json (e.g. Food.en-US.json, Food.fr-FR.json):

{
  "composition": "Ingredients",
  "nutritionDeclaration": "Nutrition Declaration",
  "labelsAndCertifications": "Labels and certifications",
  "storageAndConservation": "Storage and conservation",
  "feedingInstructions": "Preparation instructions",
  "productOrigin": "Product origin",
  "alc": "Alc."
}

These files are embedded resources in the application. Adding a new language means adding a new {TemplateName}.{locale}.json file.

Partials

Using a Partial

{{> partial-name}}

Partials inherit the current context. They can also call other partials (nested).

Custom Partials

Create your own via the Partials modal. Useful for reusable sections like nutrition tables, allergen lists, or shared headers/footers. Reference them by name in any template associated with the same retailer.

Source Data Structure

The source data is a JSON array containing one specification object per product. The template receives the full array as its root context.

Top-Level Properties

Labeling Chapter (chapters.labeling)

This is where most label data lives. Key sections:

The displayOnPack Pattern

Most labeling fields have a displayOnPack boolean. Always check it before rendering:

{{#if CommercialName.DisplayOnPack}}
  <h2>{{CommercialName.CommercialName}}</h2>
{{/if}}

Nutrition Table Example

{{#with NutritionDeclarationSection}}
{{#each NutritionDeclarations}}
<table class="nutrition-table">
  <thead>
    <tr>
      <th></th>
      {{#each ServingDefinitions}}
        <th>Per {{Size.Value}} {{Size.UnitOfMeasure.Abbreviation}}</th>
      {{/each}}
    </tr>
  </thead>
  <tbody>
    {{#each Nutrients}}
    {{#if DisplayToConsumer}}
    <tr>
      <td>{{Nutrient.Name}}</td>
      {{#each Servings}}
        <td>{{RoundedValueString}} {{../UnitOfMeasure.Abbreviation}}</td>
      {{/each}}
    </tr>
    {{/if}}
    {{/each}}
  </tbody>
</table>
{{/each}}
{{/with}}

Allergen Section (Production Chapter)

{{#each Chapters.Production}}
  {{#with AllergenSection}}
    <strong>Contains:</strong>
    {{#each RawMaterialAllergens}}
      {{Allergen.Name}}{{#unless @last}}, {{/unless}}
    {{/each}}

    {{#if CrossContamination.length}}
    <br/><em>May contain:</em>
    {{#each CrossContamination}}
      {{#unless ControlledRisk}}
        {{Allergen.Name}}{{#unless @last}}, {{/unless}}
      {{/unless}}
    {{/each}}
    {{/if}}
  {{/with}}
{{/each}}

Net Contents & E-Mark

{{#each NetContents}}
{{#if DisplayOnPack}}{{#if Value}}
  <div class="net-wt-line">
    <span class="net-wt">{{Value}}{{UnitOfMeasure.Abbreviation}}{{#if UnitOfMeasure.Name}} ({{UnitOfMeasure.Name}}){{/if}}</span>
    {{#if EMark}}<span class="emark">&#x212E;</span>{{/if}}
  </div>
{{/if}}{{/if}}
{{/each}}

Nutri-Score

{{#each NutriscoreSection.Nutriscores}}
{{#if DisplayOnPack}}
  {{{nutriscore-img Nutriscore.Grade}}}
{{/if}}
{{/each}}

Claims with Logos

{{#with Chapters.Labeling.ClaimsSection}}
{{#if Claims}}
<div class="claims-logos">
  {{#each Claims}}
  {{#if DisplayOnPack}}
  {{#if Claim.Logo.FileId}}
    {{{dms-img Claim.Logo.FileId Claim.ClaimName}}}
  {{/if}}
  {{/if}}
  {{/each}}
</div>
<div class="claims-sentences">
  {{#each Claims}}
  {{#if DisplayOnPack}}
  {{#unless Claim.Logo.FileId}}
    {{#if SentenceText}}
    <div>{{{SentenceText}}}</div>
    {{/if}}
  {{/unless}}
  {{/if}}
  {{/each}}
</div>
{{/if}}
{{/with}}

Label Template Tool — Built with Handlebars.Net