Printer configuration

Configure your printers from Configuration ‣ Printers (the printer configuration page, at /settings/configure-printers). This is also where you edit the receipt text — the shop name, address, and phone number printed on every receipt come from the Receipt header and Receipt footer fields here. Each connected controller has its own card where you choose which printer handles each type of document, and where you edit what each document type prints. 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.

There are two ways to control what a product label shows — including putting the SKU, metal, price, and other details on separate lines:

  • Zebra (ZPL) printers: design the label here with a custom ZPL layout. New to ZPL? The Designing Zebra (ZPL) labels guide explains the language step by step and lists every available variable. Use this whenever Product label Zebra printer is enabled.

  • Standard (PDF) labels: design the label visually on the Label settings page — switch each field on or off and position it with a live preview, no ZPL required.

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 insert variables in curly braces (for example {item_sku} or {price}), and Gem Logic replaces them with each product’s data when a label is printed. The Designing Zebra (ZPL) labels guide lists every available variable and explains how to use them.

Label settings (visual editor)

For standard (non-Zebra) labels you don’t need to write any ZPL. From Stock ‣ Products (or a product’s detail page), open the actions menu and choose Label settings. Here you design the label visually.

Set the label Width and Height in millimetres and an optional Rotation, then decide field by field what is printed and where:

  • Price, SKU, QR code, and Barcode

  • Supplier and Supplier references (each can be hidden once it exceeds a number of characters)

  • Attributes

  • Metals — optionally limited to specific metals, with the option to combine identical metals onto one line

Every field has a hide toggle, an X/Y position, and a font size, so you choose exactly which product information appears on the label and where it sits — for example SKU on one line and the metal on the next. A preview updates automatically as you edit, so you can see the result before printing.

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: text printed at the top of every receipt.

  • Receipt footer: text printed at the bottom of every receipt. By default it prints your shop’s contact block — name, address, phone number, email, and website — using the variables described below.

  • 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.

Shop name, address, and phone number on the receipt

You edit what a receipt prints directly on the printer configuration page (Configuration ‣ Printers, at /settings/configure-printers): the Receipt header and Receipt footer fields hold both the plain text and the variables (the “code”) that make up the top and bottom of every receipt. Change them here and save.

The shop details printed on a receipt — including the phone number — are not fixed to the receipt. By default they come from your business division through variables placed in those fields:

((division_name)) ((address)) ((postcode)) ((city)) ((state)) ((country)) ((phone)) ((email_address)) ((website)) ((iban))

When a receipt prints, each variable is replaced with the matching value from the division tied to that sales channel.

Using the variables is optional. On the same page you can also just type the details in as plain text — for example, write the phone number directly in the Receipt footer instead of ((phone)) — or mix typed text and variables in the same field.

Tip

If the phone number on your receipt is wrong, the quickest fix is to edit it right on the printer configuration page (Configuration ‣ Printers, /settings/configure-printers): open the Receipt footer (or Receipt header) and replace the ((phone)) variable with the correct number typed out, then save. If you would rather correct the number everywhere at once — receipts, invoices, quotes, and other documents — update the division’s Phone number at Configuration ‣ Company (see Address and Contact) instead.