Skip to main content

Label Templates

Admin

Label templates let you design custom product labels that can be printed on your label printer. You control the label dimensions, which fields appear (name, price, SKU, barcode, THC/CBD, etc.), and how they are laid out. Once a template is created, you can print labels for individual products or in bulk.

Label templates page

Feature flag required

Label printing is only available when Enable Label Printing is enabled in your store settings. Navigate to Settings > Edit Settings > Hardware & System tab and toggle on Enable Label Printing.

Accessing Label Templates​

  1. Log in to the Admin Panel.
  2. Navigate to the Products page.
  3. Open the dropdown menu and click Label Templates.
  4. The template list loads, showing all saved templates.

Understanding Label Templates​

Each template defines:

  • Physical dimensions -- Width and height of the label stock.
  • Content fields -- Which data fields appear on the label.
  • Layout -- How fields are positioned on the label.
  • Barcode -- Type and placement of the barcode.

Creating a Label Template​

  1. Click New Template.
  2. Fill in the template settings:

Template Name​

A descriptive name for this template.

  • Required: Yes
  • Example: "Standard Shelf Label", "Cannabis Jar Label", "Price Tag"

Label Dimensions​

Set the physical size of your label stock:

  • Width -- In millimeters (e.g., 50).
  • Height -- In millimeters (e.g., 25).
Measure your labels

Measure your actual label stock with a ruler. Even small discrepancies (1-2mm) can cause text to be cut off or misaligned. Common sizes include 50x25mm, 60x40mm, and 100x50mm.

Content Configuration​

The template content defines which elements appear on the label and how they are arranged. For each element, you can configure:

  • Element type -- Text or barcode.
  • Data field -- Which product information to display (e.g., product name, SKU, price, THC/CBD, strain type, weight, category, or brand).
  • Position -- Where the element appears on the label (horizontal and vertical placement).
  • Font size -- Size of the text for this element. Each element can have its own font size, so you can make the price larger than the SKU, for example.
  • Alignment -- Left, center, or right alignment.
  • Bold -- Whether the text is displayed in bold.

Barcode Settings​

If you enabled the barcode field:

  • Barcode Type -- Choose from Code 128 (recommended), EAN-13, or QR Code.
  • Barcode Data -- Select what the barcode encodes: SKU (default) or a custom field.
  • Barcode Position -- Top, bottom, left, or right of the label.
  • Barcode Size -- Small, medium, or large relative to the label.
  1. Click Save Template.

Previewing a Template​

After saving, you can preview how the label will look:

  1. Open the template.
  2. Click Preview.
  3. A sample label renders using data from a random product in your catalog.
  4. Verify that all fields fit within the label boundaries and text is legible.
Test print before bulk printing

Always test print 1-2 labels on your actual printer before running a large batch. Screen previews may not perfectly match physical output due to printer DPI differences.

Editing a Template​

  1. Click the template name in the list.
  2. Modify any settings.
  3. Click Save Template.

Editing a template does not reprint any previously printed labels. Only future print jobs use the updated template.

Deleting a Template​

  1. Open the template.
  2. Click Delete Template.
  3. Confirm.

Default templates cannot be deleted. Non-default templates can be deleted regardless of count.

Setting a Default Template​

  1. On the template list page, click the star icon next to the template you want as default.
  2. The default template is used when printing labels from the product list or POS register unless you explicitly select a different one.

Printing Labels​

Single Product Label​

  1. Navigate to Products and find the product.
  2. Click the actions menu (three-dot icon) on the product row.
  3. Click Print Label.
  4. Select the template (or use the default).
  5. Enter the number of copies.
  6. Click Print.

Bulk Label Printing​

  1. Navigate to Products.
  2. Select multiple products using checkboxes.
  3. Click Bulk Actions > Print Labels.
  4. Select the template.
  5. Enter copies per product (or set individual quantities).
  6. Click Print.

From the POS Register​

If label printing is enabled, budtenders can print labels directly:

  1. On the POS, find the product.
  2. Long-press (or right-click) the product tile.
  3. Select Print Label.
  4. The label prints using the default template.

Printer Configuration​

Label templates work with ZPL-compatible (Zebra) and EPL-compatible label printers.

Network Printer​

  1. Navigate to Settings > Edit Settings > Hardware & System tab, then find the label printer settings.
  2. Enter the printer's IP address and port (default: 9100).
  3. Click Test Connection.
  4. Print a test label to verify.

USB Printer via Printer Bridge​

If your label printer is connected via USB:

  1. Ensure the Printer Bridge is running.
  2. The bridge listens on port 9101 for label print jobs.
  3. Configure the label printer IP as your Printer Bridge host and port 9101.
Dual printer setup

Most stores use two printers: a receipt printer (port 9100) and a label printer (port 9101). The Printer Bridge handles both simultaneously.

Cannabis-Specific Labels​

For cannabis products, labels often need to include regulatory information:

  • THC/CBD percentages -- Required in many jurisdictions.
  • Health warnings -- Use the Custom Text field to add mandatory warning text.
  • Lot/batch number -- If tracked, include the SKU field which can be set to the lot number.
  • Weight -- Required for products sold by weight.
Regulatory requirements

Check your provincial and federal regulations for cannabis labeling requirements. Brother POS provides the tools to include required information, but compliance is your responsibility.

Best Practices​

  • Create templates for different use cases -- A small shelf label, a larger jar label, and a price tag template cover most needs.
  • Include barcodes -- Barcodes enable fast scanning at the POS. Always include them if space allows.
  • Test with your actual printer -- DPI, margin, and alignment vary by printer. Test before printing hundreds of labels.
  • Keep a stock of label rolls -- Running out of labels during a busy relabeling session is frustrating. Keep spares on hand.
  • Update labels after price changes -- When you change prices, reprint affected labels. Mismatched shelf labels and POS prices cause customer confusion.
  • Use large font for price -- Customers look at price first. Make it the most prominent field on the label.

What's Next?​