Product Label Templates
How to Access
"Products" → "Label Templates" → Click template name
Contents
1. Use Cases
Quick Links: Check New Template | Learn Template Syntax
Scenario 1: Verify newly created template is correct
Situation: Just created a new label template and want to confirm the layout and data display are correct.
How to do it:
▸ View Preview
- Navigate to template details page
- View the "Label Preview" section
- Check if product name, barcode, etc. display correctly
- Confirm layout does not exceed boundaries
▸ If Issues Found
- Click "Edit" button to modify
- Preview again after modifications until satisfied
Result: Confirm template settings are correct, avoiding issues after printing.
Scenario 2: Learn Liquid template syntax
Situation: Want to learn how to use template language to design labels.
How to do it:
▸ Reference Examples
- Navigate to an existing template's details page (recommend choosing a default template)
- Carefully read the code in the "Template Content" section
- Observe how product variables are used
- Observe barcode generation syntax
- Compare with "Label Preview" to see actual effects of code
Result: Learn from actual examples to quickly master basic syntax.
2. Feature Guide
The Label Template details page allows you to view complete template settings and content. You can verify paper size, preview actual display using "Label Preview", review template code, and perform edit or delete actions. This is an essential page for confirming template settings are correct.
Quick Jump: Basic Info | Template Content | Label Preview | Action Buttons
2.1 Basic Info
| Field | Description |
|---|---|
| Template Name | Used to identify and select templates |
| Merchant | Click to view other data for this merchant |
| Description | Records purpose or applicable scenarios |
| Is Default | Default templates show a "Yes" badge and are auto-selected when printing |
| Paper Size | e.g., "70mm × 50mm" |
| Created At | When first saved |
| Updated At | When last modified |
2.2 Template Content
Displays complete template code, including layout structure, style settings, and variables used.
2.3 Label Preview
Previews actual label display using sample product data. You can verify:
- Layout arrangement is correct
- Barcode and QR Code display properly
- Content does not exceed paper boundaries
2.4 Action Buttons
| Button | Function |
|---|---|
| Edit | Navigate to edit page to modify template |
| Delete | Delete this template (cannot be recovered) |
3. FAQ
Quick Jump: FAQ | Important Notes
3.1 FAQ
▪ Does preview use real product data?
No. Preview uses system-provided sample product data. Real product data will be used when actually printing.
▪ Can I edit the template directly from this page?
No. The details page is read-only. To modify, click the "Edit" button to navigate to the edit page.
▪ What if the preview shows "Render Error"?
It means the template content has a syntax error and the preview cannot be generated. Click "Edit" to fix the content; while editing, click "View Liquid Docs" to check the correct syntax.
▪ How can I quickly copy a template's settings?
Currently the system does not support template copying. You can view and record template content on the details page, then manually paste when creating a new template.
▪ Can I recover a deleted template?
No. Deleting a template is permanent and cannot be recovered. Confirm nothing else is using this template before deleting.
3.2 Important Notes
⚠️ Key Reminders
- Preview uses sample data; actual results may vary based on different product data
- Deleted templates cannot be recovered; proceed with caution
- Modifying default templates affects all future label printing for that merchant
4. Related Features
| Feature | Description | Link |
|---|---|---|
| Label Templates List | Manage all label templates | Go |
| New Product Label Template | Create a new label template | Go |
| Edit Product Label Template | Modify existing template | Go |