Edit Product Label Template
How to Access
"Products" → "Label Templates" → Click "Edit"
Contents
1. Use Cases
Quick Links: Customize Clothing Labels | Adjust Paper Size
Scenario 1: Customize labels for clothing products
Situation: Existing template is missing "Size" and "Color" fields that need to be added.
How to do it:
▸ Modify Template Content
- Navigate to template edit page
- Find the product name section in the "Template Content" editor
- Add size and color variables below
- Click "Preview" to verify display is correct
- Click "Save"
Result: Labels clearly display product size and color, preventing warehouse staff from picking wrong specifications.
Scenario 2: Adjust label paper size
Situation: Warehouse purchased 80mm × 60mm special label paper and needs to adjust template size.
How to do it:
▸ Set Custom Size
- Navigate to template edit page
- In "Paper Size Type" select "Custom Size"
- Enter "Paper Width (mm)": 80
- Enter "Paper Height (mm)": 60
- Click "Preview" to confirm layout fits within boundaries
- Click "Save"
Result: Template size matches actual label paper, preventing content from exceeding boundaries when printing.
2. Feature Guide
The Edit Label Template feature allows you to modify existing template settings and content. You can adjust Template Name, Description, paper size, template code, and set or unset Is Default. While editing, you can use "Preview" to instantly verify changes.
Note: Merchant assignment is determined at creation and cannot be changed.
Quick Jump: Editable Fields | Template Content | Action Buttons
2.1 Editable Fields
| Field | Editable | Description |
|---|---|---|
| Merchant | ❌ | Determined at creation, cannot be changed |
| *Template Name | ✅ | Recommended format: "Size-Purpose" |
| Description | ✅ | Records purpose or scenarios for easy identification |
| Is Default | ✅ | When checked, auto-applied during printing |
| Paper Size Type | ✅ | Select preset size or enter custom dimensions |
| Template Content | ✅ | Design layout using Liquid syntax |
2.2 Template Content
Template Content uses Liquid template language to display product information and barcodes.
▸ Common Variables
| Variable | Corresponding Data |
|---|---|
| product.name | Product name |
| product.sku | Product SKU |
| product.barcode | Product barcode value |
| product.category | Product category |
| product.material | Product material |
| product.note | Product note |
| brand.name | Brand name |
| merchant.name | Merchant name |
📌 Note: If the merchant has defined custom product attributes (e.g., size, color), they can also be shown on labels as "product.attribute_code". Click "View Liquid Docs" for the full list.
▸ Barcode & QR Code
Use barcode filter to generate barcode images, use qrcode filter to generate QR Code images.
▸ Conditional Logic
You can use conditional logic in templates to only display content when fields have values.
2.3 Action Buttons
| Button | Function |
|---|---|
| Save | Save changes and update template |
| Cancel | Discard changes and return to previous page |
| Preview | Instantly preview label effect |
| Split Preview | Open right-side instant preview panel |
3. FAQ
Quick Jump: FAQ | Important Notes
3.1 FAQ
▪ Will modifying the default template affect already printed labels?
No. Already printed labels are not affected. Changes only apply to new labels printed using this template afterward.
▪ What if the label content exceeds the paper area?
You can adjust it by:
- Reducing font size
- Decreasing spacing
- Removing unnecessary fields
- Choosing a larger paper size
After adjusting, click "Preview" to confirm nothing overflows before saving.
▪ How can I back up template content?
Before editing, go to the details page first, copy all code from "Template Content", and save to a text file.
▪ Can I change which merchant this template belongs to?
No. Merchant assignment is determined at creation and cannot be changed. To change merchants, create a new template for the new merchant.
▪ How do I load product data for preview?
Click the "Load Product Data" button, search and select a product, then you can preview label effects using that product's real data.
3.2 Important Notes
⚠️ Key Reminders
- Merchant assignment cannot be changed; this is determined at creation
- Modifying default templates affects all future label printing for that merchant
- After editing, click "Preview" to confirm layout is correct before saving
4. Related Features
| Feature | Description | Link |
|---|---|---|
| Label Templates List | Manage all label templates | Go |
| Product Label Templates Details | View template settings and preview | Go |
| New Product Label Template | Create a new label template | Go |