Asset Tag Printing¶
Module: Asset Tag Printing | Audience: All Users
Table of Contents¶
- Overview
- Asset Tag Templates
- Template List
- Creating a Template
- Template Designer
- Saving a Template
- Editing a Template
- Deleting a Template
- Printing Asset Tags
- Single Asset — From Asset Detail
- Bulk Print — From Asset List
- The Generate Sticker Dialog
- PDF Output & Printing
Overview¶
The Asset Tag Printing module lets you define reusable label templates and generate print-ready PDFs for individual assets or multiple assets in a single request. Each printed tag encodes the asset's unique identifier as a barcode or QR code, with optional text fields and an image (e.g., a logo or other custom graphic).
The workflow has two parts:
- Template Management — design and save label layouts in the Asset Tag Template designer.
- Print — select assets, pick a template, choose copy count, and download the PDF.
Asset Tag Templates¶
Template List¶
Path: Sidebar → Asset Tag Template | URL: /asset-tag-template
Displays all saved templates in a paginated table.
| Column | Description |
|---|---|
| Name | Unique template identifier |
| Type | Barcode / QR Code |
| Label Width / Height | Physical label dimensions |
| Default | Whether this template is pre-selected in the print dialog |
| Active | Whether the template is available for printing |
| Action | How |
|---|---|
| Create a template | Click + Create Template |
| Edit a template | Click the edit (pencil) icon on a row |
| View template detail | Click a template row |
| Delete a template | Click the delete icon on a row |
Note: Only one template can be marked as Default. The default template is pre-selected automatically when the Generate Sticker dialog opens.
Important: The Default template cannot be deleted. Reassign the default to another template before deleting.
Creating a Template¶
Path: Asset Tag Template → + Create Template | URL: /asset-tag-template/new
Clicking + Create Template opens the Template Designer — a visual canvas where you arrange elements and configure all label settings before saving.
Template Designer¶
Path: Asset Tag Template → Create / Edit | URL: /asset-tag-template/new · /asset-tag-template/:id/edit
The designer is divided into three areas:
| Area | Purpose |
|---|---|
| Header / Toolbar (top) | Template name input; element buttons; undo/redo; zoom; delete/duplicate; Save/Cancel |
| Canvas (centre) | Live visual preview of the label; drag elements to position and resize them |
| Properties Panel (right) | Configure the selected element's properties and overall label settings |
The designer also has a Print Preview tab (top-centre) that renders a pixel-accurate canvas preview of how the finished label will look before saving.
Toolbar Actions¶
| Button | Description |
|---|---|
| Barcode | Add a CODE 128 barcode element |
| QR Code | Add a QR code element |
| Text | Add a text element |
| Image | Add an image element |
| Undo / Redo | Step back or forward through design history |
| Zoom In / Out | Adjust the canvas zoom level |
| Delete | Remove the currently selected element |
| Duplicate | Clone the currently selected element |
Drag an element button from the toolbar directly onto the canvas to place it at a specific position, or click the button to centre-place it on the label.
Note: Each element type (barcode, QR code, text, image) can appear once per template.
Canvas Elements¶
| Element | What it shows on the label | Notes |
|---|---|---|
| Barcode | CODE 128 barcode encoding the asset tag | At least one of Barcode or QR Code is required |
| QR Code | QR code encoding the asset tag | At least one of Barcode or QR Code is required |
| Text | One line of configurable text composed from asset field placeholders | Optional |
| Image | A logo or custom graphic uploaded at design time | Optional; an image file must be uploaded if the element is placed |
Once an element is on the canvas, click it to select it. The Properties Panel on the right shows its position (X, Y), size (Width, Height), and type-specific settings. Drag the element to reposition it; drag its corner handles to resize.
Text Field Configuration¶
When the Text element is selected, the Properties Panel shows a Fields chip palette with three draggable placeholders:
| Chip | Placeholder | Value substituted at print time |
|---|---|---|
| Asset Tag | {asset_tag} |
The asset's unique tag (e.g. AST-0001) |
| Asset Name | {asset_name} |
The asset's name (e.g. Laptop Pro) |
| Category | {category} |
The asset's category name (e.g. IT Equipment) |
To compose the text:
- Drag a chip from the Fields palette into the drop zone below it.
- Repeat for additional fields — a
|separator is inserted automatically between chips. - Click × on any chip to remove it from the text.
| Text property | Description |
|---|---|
| Font | Helvetica, Arial, Times New Roman, Courier, Georgia, Verdana |
| Font Size | Point size (minimum 4 pt) |
| Style | Bold, Italic |
| Alignment | Left, Centre, Right |
| Text Color | Colour picker |
Tip: The canvas preview substitutes sample values (
AST-0001,Laptop Pro,IT Equipment) so you can check layout and font size before saving.
Label & General Parameters¶
Visible in the Properties Panel when no element is selected (or scroll past the element section).
| Parameter | Type | Description |
|---|---|---|
| Width | Number | Label width in the selected unit |
| Height | Number | Label height in the selected unit |
| Unit | mm / inch / dots | Measurement unit for all dimensions |
| Orientation | Portrait / Landscape | Label orientation |
| Background Color | Color picker | Label background fill color |
Printer Properties¶
| Parameter | Type | Description |
|---|---|---|
| Batch Cut | Number | Cut the media every N labels |
| Cut After Printing | Checkbox | Perform a final cut after the job completes |
| Print Speed | Number | Printer speed setting |
| Print Mirror | Checkbox | Mirror-image the label (for transparent media) |
| Is Continuous | Checkbox | Enable continuous (roll) media mode |
Media & Calibration Parameters¶
| Parameter | Type | Description |
|---|---|---|
| Gap Length | Number | Gap between labels on roll media |
| Mark Length | Number | Black mark length (for mark-sensing media) |
| Offset Length | Number | Label offset from the sensor |
Sheet Configuration¶
Used when printing multiple labels arranged on a sheet (e.g. A4 label sheets).
| Parameter | Type | Description |
|---|---|---|
| Sheet Label Height | Number | Height of each label position on the sheet |
| Labels Per Row | Number | Number of labels across one sheet row |
| Labels Count | Number | Total label positions on the sheet |
| Labels Horizontal Gap | Number | Horizontal gap between labels |
| Margin Top / Bottom / Left / Right | Number | Sheet edge margins |
Saving a Template¶
Enter a Template Name in the top-left input of the designer header, then click Save.
The following rules are enforced before saving:
| Rule | Error message |
|---|---|
| Template name is blank | "Template name is required" |
| No barcode or QR code element on the canvas | "Please add at least a Barcode or QR Code element to the template" |
| Image element placed but no image uploaded | "Please upload an image or remove the image element from the canvas" |
Note: Template names must be unique across all templates.
Editing a Template¶
Path: Asset Tag Template → edit icon | URL: /asset-tag-template/:id/edit
Opens the Template Designer pre-populated with the saved layout. All elements and settings are editable. Click Update to save changes. The same validation rules apply.
Deleting a Template¶
Click the delete icon on a template row in the template list.
Important: The Default template cannot be deleted. To delete it, first mark another template as Default, then delete the original.
Printing Asset Tags¶
Single Asset — From Asset Detail¶
Path: Assets Listing → click an asset row → Overview tab | URL: /assets/:id
A Generate Sticker button is available on the Asset Detail page. Click it to open the Generate Sticker dialog.
Bulk Print — From Asset List¶
Path: Sidebar → Assets Listing | URL: /assets
- Select one or more assets using the checkboxes in the leftmost column of the asset list.
- Once at least one asset is checked, a Generate Sticker button appears in the page header.
- Click Generate Sticker to open the Generate Sticker dialog for all selected assets.
Note: There is no per-row print button in the asset table — use checkboxes to select assets before clicking Generate Sticker.
The Generate Sticker Dialog¶
After clicking Generate Sticker from either entry point, a dialog appears with two fields:
| Field | Type | Description |
|---|---|---|
| Template | Autocomplete dropdown | Lists all active templates; the Default template is pre-selected |
| No. of Copies | Number (1–100) | Number of copies to print per selected asset |
Click Print to generate the PDF. Click Cancel to dismiss the dialog without printing.
PDF Output & Printing¶
- The system generates a PDF file server-side using the selected template layout and the real asset data for each selected asset.
- The PDF opens automatically in a new browser tab.
- Use the browser's built-in print function (Ctrl+P / Cmd+P) to send it to a physical printer, or save the PDF for later.
- Each tag encodes the asset's Asset Tag value in the barcode/QR code.
Tip: For accurate physical sizing, match the template's label dimensions (Width × Height) to your physical label stock before printing. Use the Print Preview tab in the designer to verify layout before saving the template.
Note: The Print Preview in the designer uses sample asset data. The final printed output uses actual asset values and may differ slightly due to printer calibration.
Related: Asset Management · Master Data Configuration