Printer configuration

Configure your printers from Configuration ‣ Printers. Each connected controller has its own card where you choose which printer handles each type of document. Every field is optional—only fill in the printer types you actually use.

General settings

  • Name: a friendly name for this controller’s configuration.

  • Marketplace: the marketplace this configuration applies to.

  • Active: enable or disable this configuration.

Document / A4 printer

For standard documents such as invoices, quotes, and order forms.

  • Document printer name: the exact name of the printer as it appears in Windows (for example, HP LaserJet Pro).

Certificate printer

For printing certificates.

  • Certificate printer name: the printer used for certificates.

  • Certificate landscape: print certificates in landscape orientation.

  • Certificate ZC300 printer: enable when using a Zebra ZC300 card printer (the certificate is sent as a BMP image).

Product label printer

For printing product labels, typically on Zebra label printers using ZPL (Zebra Programming Language).

  • Product label printer name: the printer used for labels.

  • Product label Zebra printer: enable for Zebra ZPL-compatible printers.

You can define two independent label designs (for example, a standard label and a smaller label). For each design you can set:

  • Label design name: a name to recognize the design.

  • Product label width: label width in dots (default 448 dots ≈ 56 mm at 203 DPI).

  • Product label length: label length in dots (default 104 dots ≈ 13 mm at 203 DPI).

  • Custom Zebra product label design: the ZPL layout for the label.

A preview image is generated automatically when you save a design, so you can see the result before printing.

Label design variables

Inside the ZPL design you can insert variables in curly braces. Gem Logic replaces them with each product’s data when a label is printed.

Product

  • {brand}: brand name

  • {product_title}: product title

  • {item_sku}: product SKU

  • {ean_code}: EAN barcode (used for the QR code)

  • {price} and {currency}: price and currency symbol

  • {serial_number}: serial number

  • {year_of_manufacture}: year of manufacture

  • {supplier_product_reference}: supplier’s product reference

  • {supplier_reference}: supplier reference

Materials and gems

  • {material_1} to {material_5}: full material description (weight, name, and gem details)

  • {material_only_1} to {material_only_5}: material or gem name only

Attributes

  • {attribute_1} to {attribute_5}: attribute as name: value

  • {attribute_name_1} to {attribute_name_5}: attribute name only

  • {attribute_value_1} to {attribute_value_5}: attribute value only

Dimensions

  • {weight}, {length}, {width}, {height}, {diameter}, {size}, {thickness}, {quality}

Layout

  • {label_length}: filled in automatically from the label length setting

Repair label printer

For printing repair job labels.

  • Repair label printer name: the printer used for repair labels.

  • Repair label small: use a smaller label format.

  • Repair label height: a custom label height (optional).

Receipt printer

For printing receipts on thermal printers (for example, the Epson TM-T20III).

  • Receipt printer name: the printer used for receipts.

  • Receipt header: custom text printed at the top of receipts.

  • Receipt footer: custom text printed at the bottom (for example, business details or a return policy).

  • Receipt width: number of characters per line (default 48).

  • Receipt logo BMP file: a monochrome BMP file printed as the receipt logo.

  • Receipt printer IN EP and Receipt printer OUT EP: USB input/output endpoints for direct communication (advanced).

Note

The IN/OUT endpoints are only needed for direct USB communication with Epson ESC/POS printers. Leave them empty unless you use a USB connection that requires raw printing.