Food & retail thermal tickets
Set pdfOptions width (e.g. 80mm), zero html/body margins to avoid extra pages. See the 80mm demo.
Thermal receipts & shipping label silent print
Retail receipts, 80mm thermal tickets, and WMS shipping labels usually need silent output to a named thermal printer—no browser dialog. Describe layouts in HTML/CSS, then printHtml / batchPrint via web-print-pdf on Windows POS, Mac store PCs, and Linux/domestic warehouse desktops with one codebase.
Thermal / label print architecture
Describe paper in HTML/CSS. Local: browser printHtml / batchPrint. Remote peak: no npm—enqueue the same JSON on your server; desk client enters the consumer API URL (remote print, WMS push).
Typical scenarios
WMS waybills / parcel labels
Push HTML or URLs from OMS; warehouse PCs batch silent-print. Pair with remote print. See batch labels demo.
Windows front + domestic OS back office
Same npm package: Windows exe and Kylin/UOS deb clients share the API—one print stack to maintain.
Integration steps
- Install the Web Print Expert client on POS/warehouse PCs
npm install web-print-pdf- Author HTML/CSS for paper width (zero margins on thermal)
- Call
printHtmlorbatchPrintwithprintOptions.printerName - High volume: enable remote WebSocket/HTTP push
80mm receipt parameter sketch
await webPrintPdf.printHtml(
receiptHtml,
{ width: '80mm', height: '120mm', printBackground: true },
{ printerName: 'Thermal printer', copies: 1 }
);Parameter checklist
- Width: pdfOptions
width/height(e.g. 80mm), not A4 - Margins:
html, body { margin:0; padding:0; }in HTML - Printer:
printOptions.printerNamefrom client enumeration - Batch: peak label volume via
batchPrint—see print options guide
Choose by paper type
| Paper | pdfOptions | Typical use |
|---|---|---|
| 80mm receipt | width: 80mm, margin:0 | Food & retail POS |
| 100×150 label | Exact width/height, zero margins | Shipping, WMS |
| A4 report | paperFormat: A4 | See print options |
Troubleshooting checklist
- Blank/extra pages: body margin & pdfOptions height
- Clipped content: paper narrower than fixed HTML width
- Wrong printer: match
printerNameto client list - Mac/domestic OS: dmg/deb clients, same API as Windows
How this page fits with related guides
- This page: thermal receipts & label HTML
- WMS remote labels: unattended server push
- 80mm demo / batch labels
- Kylin / UOS: domestic warehouse desks
FAQ
Blank pages or extra pages on thermal paper?
Usually default body margins or oversized paper height. Follow the 80mm demo—zero margins and match pdfOptions to physical width.
Silent print labels without a browser dialog?
Yes with web-print-pdf + local client. window.print always shows a dialog.
ERP pushes jobs; warehouse auto-prints?
Yes—maintain jobs on your server, expose WebSocket/HTTP, and configure that URL on the desk client—not printHtml in a browser. See the remote print guide.
Mac stores or domestic Linux terminals?
Supported—official macOS dmg and Linux deb (Kylin/UOS) use the same printHtml API as Windows.
Migrate Lodop labels to HTML?
Many shipping labels suit HTML PoC; precision overlays can stay on Lodop in parallel. See parallel Lodop guide.
Client deployment by platform
The same web-print-pdf front-end runs on Windows, macOS, and Linux/domestic OS—install the matching client on each desktop.