Aurelia Hub includes a complete label printing system for creating and printing product labels with customizable templates, QR codes, and automated print queues.
Components
The label printing system consists of three parts:
- Label Templates — Design the label layout
- Print Jobs — Queue and manage print tasks
- Printer Config — Configure physical printers
Label Templates
Navigate to Inventory > Label Templates.
Creating a Template
- Name — Template identifier (e.g., "Standard Price Tag", "Showcase Label")
- Slug — URL-friendly identifier
- Description — Template purpose
- Template Content — HTML/CSS template with variable placeholders
- Paper Size — Standard paper size
- Width / Height — Label dimensions in mm
- Orientation — Portrait or Landscape
- Margins — JSON object for top/right/bottom/left margins
- Include QR Code — Toggle QR code generation
- QR Code Position — Where to place the QR code
- QR Code Size — Size in pixels
- Is Active / Is Default — Status flags
Template Variables
Use double-brace syntax in your template content:
| Variable | Description |
|---|---|
{{product.name}} |
Product name |
{{product.sku}} |
SKU |
{{product.article_number}} |
Article number |
{{product.price}} |
Formatted price (e.g., "€ 1.250,-") |
{{product.cost}} |
Formatted cost price |
{{product.description}} |
Description |
{{product.category.name}} |
Category name |
{{product.collection}} |
Collection name |
{{product.metal}} |
Metal type |
{{product.metal_color}} |
Metal color |
{{product.metal_purity}} |
Metal purity |
{{product.metal_display}} |
Combined metal info (e.g., "750/White Gold") |
{{product.number_of_stones}} |
Stone count |
{{product.stone_weight}} |
Stone weight in carats |
{{product.stone_color}} |
Stone color |
{{product.stone_clarity}} |
Stone clarity |
{{product.stone_display}} |
Full stone line (e.g., "3st 0,50 ct G/VS1") |
{{product.diamond_color}} |
Diamond color grade |
{{product.diamond_clarity}} |
Diamond clarity grade |
{{product.diamond_carat}} |
Diamond carat weight |
{{product.quantity}} |
Current quantity |
{{product.status}} |
Product status |
{{qr_code}} |
Generated QR code |
{{current_date}} |
Today's date (dd.mm.yyyy) |
{{current_time}} |
Current time (HH:mm) |
Media Support
Templates support uploading:
- Logos — Company logo for label headers (JPEG, PNG, WebP, SVG)
- Backgrounds — Background images for the label
Print Jobs
Navigate to Inventory > Print Jobs.
Print jobs are created when you queue a label for printing:
- Template — Which label template to use
- Product — The product to print a label for
- Quantity — Number of copies
- Status — Pending, Printing, Completed, Failed
- Printer — Target printer
Printer Configuration
Navigate to Inventory > Printer Config.
Configure your label printers:
- Name — Printer identifier
- Type — Printer type/protocol
- Connection — Connection details (IP address, USB, etc.)
- Is Active — Enable/disable printer
- Default Template — Associate a default label template
QR Codes
Products can have QR codes generated automatically:
- QR codes link to the product's admin page:
/admin/products/{id} - Generated as PNG images and stored in
storage/app/public/qr-codes/ - Filename format:
qr-{SKU}.png - QR codes can be included on printed labels using the
{{qr_code}}variable
Workflow Example
- Design a label template with your store branding and desired variables
- Configure your label printer
- Select products and create print jobs
- Labels are rendered with real product data and sent to the printer
- Attach printed labels to your products in the showcase