Label Templates - LabelLight Documentation

What is a Label Template?

A label template is a file that defines:

Label Size - The physical dimensions of the label (e.g., 30mm x 89mm)
Layout - Where text, barcodes, and images are positioned
Styling - Fonts, sizes, alignment, and formatting
Field Placeholders - Named objects that will be replaced with product data

LabelLight uses standard DYMO label template files with .label or .dymo extensions.

📸 Screenshot: Example label template in DYMO Label Software

Creating a Label Template

You create label templates using DYMO Label Software, which is included with DYMO Connect.

Open DYMO Label Software
Launch DYMO Label Software from your computer.
Select Label Size
Choose the label size that matches your label roll (e.g., 30323 Shipping Labels, 30252 Address Labels).
Add Objects
Use the toolbox to add text objects, barcode objects, and image objects to your label.
Name Your Objects
Give each object a meaningful name (e.g., "ProductName", "Price", "SKU"). These names will be used for field mapping.
Style Your Label
Set fonts, sizes, alignment, and positioning to create your desired design.
Save the Template
Save your label as a .label file. Use File > Save As and choose the location.

💡 Object Naming

Use descriptive names for your objects like "ProductName", "Price", "SKUBarcode". Avoid spaces and special characters. These names appear in LabelLight's field mapping interface.

Template Object Types

DYMO templates support several types of objects:

📝 Text Objects

Display text content like product names, descriptions, or prices.

Can be single-line or multi-line
Support various fonts and sizes
Can include static text combined with mapped fields

📊 Barcode Objects

Generate scannable barcodes from text data like SKUs.

Support multiple barcode formats (Code128, UPC, EAN, QR Code)
Can optionally show the barcode text below
Commonly used for SKU or product codes

🖼️ Image Objects

Display static images like logos.

Can display your company logo (uploaded in LabelLight settings)
Fixed position and size on the label

📸 Screenshot: DYMO Label Software showing text, barcode, and image objects

Recommended Label Layouts

Here are some common label layouts for retail use:

Basic Product Label

Object Name	Type	Maps To
ProductName	Text	name
Price	Text	price_including_tax
SKUBarcode	Barcode	sku

Detailed Product Label

Object Name	Type	Maps To
ProductName	Text	name
Brand	Text	brand.name
SKU	Text	sku
Price	Text	price_including_tax
Barcode	Barcode	sku
Logo	Image	(Your uploaded logo)

📸 Screenshot: Examples of basic and detailed label layouts

Uploading Templates to LabelLight

Open Extension Settings
Click the LabelLight icon and open settings.
Navigate to Label Templates
Scroll to the "Label Templates" section.
Upload Your Template
Click the upload area or drag and drop your .label file.
Set as Default
Click "Set as Default" to make this your primary printing template.

⚠️ Supported Label Types

LabelLight works with die-cut labels (standard label rolls). Continuous tape labels may not be fully supported.

Managing Multiple Templates

You can upload multiple templates for different use cases:

Small price tags - For shelf pricing
Large product labels - For product packaging
Shipping labels - For order fulfillment

When printing, you can select which template to use from the template dropdown in the print modal.

Template Management Actions

Set as Default - Makes a template the primary choice
Delete - Removes a template from your list

Best Practices

✅ Template Design Tips

Use clear, readable fonts - Sans-serif fonts work best for small labels
Leave margins - Don't place objects too close to label edges
Test print - Always test your template with real data before bulk printing
Name objects clearly - Use descriptive names for easy field mapping
Consider barcode size - Ensure barcodes are large enough to scan reliably
Keep it simple - Too much information makes labels hard to read