Skip to main content
The Template Editor allows you to create custom receipt layouts with text, barcodes, QR codes, images, and tables. Templates are organized into sections and elements for maximum flexibility.

​
Understanding Templates

Templates consist of:
  • Template Name - Identifier for the template
  • Sections - Logical groups of content (header, body, footer, etc.)
  • Elements - Individual print items within each section (text, barcode, image, etc.)

​
Opening the Template Editor

1

Navigate to Templates

From the main menu, select Templates to view available print templates.
2

Select a Template

Click on an existing template to edit it.The editor will load with all sections and elements visible.
3

Edit Template Name

At the top of the editor, you can change the template name in the text field.Example: Factura de Venta, Recibo de Caja, Ticket Cocina

​
Working with Sections

Sections organize your template into logical blocks like headers, item lists, and footers.

​
Adding a Section

1

Click Add Section

Click the + Sección button in the header to create a new section.
2

Configure Section Properties

Name - Section identifier (e.g., “Encabezado”, “Items”, “Pie de Página”)Type (Type) - Section behavior:
  • Static - Prints once with fixed content
  • Repeating - Repeats for each item in a data source
Alignment (Align) - Content alignment:
  • Left
  • Center
  • Right
Data Source (DataSource) - Only visible for repeating sections
Select which data collection to iterate over (e.g., Items, Payments)Format - Text formatting:
  • Size dropdown: Small, Medium, Large, etc.
  • N checkbox: Bold text
3

Expand/Collapse Section

Click the ▼ or ▶ icon to toggle section visibility.

​
Section Controls

ButtonAction
▼/▶Expand/collapse section
↑Move section up
↓Move section down
+Add element to section
✕Delete section

​
Working with Elements

Elements are the individual print items within a section.

​
Adding an Element

1

Add Element to Section

Click the + button in the section header to add a new element.
2

Select Element Type

Choose from:
  • Text - Display text or data fields
  • Barcode - Print 1D barcodes
  • QR - Print QR codes
  • Image - Print images
  • Table - Print tabular data

​
Element Types

Display static text or dynamic data fields.Static/Dynamic Toggle
  • Static - Fixed text entered manually
  • Dynamic - Data from a source field
Label - Optional prefix label (e.g., “Cant:”, “Total:”)Value (for static) - The text to printSource (for dynamic) - Data field to display
Examples: DocumentNumber, CustomerName, TotalAlignment - Left, Center, RightSize - Font sizeBold - Make text bold

​
Element Controls

ButtonAction
↑Move element up
↓Move element down
✕Delete element

​
Data Sources and Field Suggestions

The editor provides field suggestions based on your document type. Common fields include:
  • DocumentNumber - Invoice/receipt number
  • DocumentDate - Transaction date
  • CustomerName - Customer name
  • Total - Total amount
  • Items - Line items collection
  • Quantity - Item quantity
  • Description - Item description
  • Price - Item price
Available fields vary depending on the document type (Invoice, Receipt, Kitchen Ticket, etc.)

​
Saving Your Template

1

Review Your Design

Scroll through all sections to verify your layout.Ensure all data sources are correctly mapped.
2

Save Template

Click Guardar Plantilla at the bottom of the editor.A success message confirms the template was saved.
3

Test Printing

Navigate back to the template list and test print with sample data.

​
Template Design Tips

Use Sections Wisely

Separate header, repeating items, and footer into distinct sections for clarity.

Alignment Matters

Center titles and totals, left-align item descriptions, right-align prices.

Test with Real Data

Always test templates with actual transaction data before production use.

Keep It Simple

Thermal printers have limited width - avoid overcrowding elements.

​
Common Template Patterns

​
Invoice Header

Section: "Header" (Static, Center)
  Element: Text (Static) - Store Name (Large, Bold)
  Element: Text (Static) - Store Address (Small)
  Element: Text (Dynamic) - Document Number
  Element: Text (Dynamic) - Document Date

​
Repeating Line Items

Section: "Items" (Repeating, DataSource: Items)
  Element: Table - Quantity (10% width)
  Element: Table - Description (60% width)
  Element: Table - Price (30% width, right-aligned)

Section: "Footer" (Static, Center)
  Element: Text (Dynamic) - Total (Large, Bold)
  Element: QR - Payment URL (Size: 6)
  Element: Text (Static) - "Gracias por su compra"

​
Troubleshooting

  • Ensure template name is not empty
  • Check that all required data sources are selected
  • Verify you have write permissions to the templates directory
  • Confirm the data source field name matches exactly (case-sensitive)
  • Ensure the data is present in the print job payload
  • Check that dynamic elements have “Source” configured, not “Value”
  • Verify paper width matches printer configuration (58mm vs 80mm)
  • Avoid using table widths that exceed 100% total
  • Test alignment with different paper sizes
  • Close and reopen the editor
  • Reduce the number of elements in large repeating sections
  • Clear browser cache if using web interface

Printer Configuration

Configure printers for your templates

API Reference

Template API endpoints

Build docs developers (and LLMs) love

Get started for freeTalk to us