Skip to main content
Version: 1.x

Templates

WCPOS includes a template system for customising receipts, with a gallery of starter templates and an in-app editor. Templates are managed in WP Admin > POS > Templates.

Template Engines

WCPOS supports three template engines. The engine is chosen when you create or install a template and cannot be changed afterward.

HTML (Offline)

Logicless Mustache-style templates using {{variable}} placeholders. Renders client-side — works offline. Recommended for most users.

XML (Thermal Printer)

XML-based templates that produce both a screen preview and ESC/POS commands for thermal receipt printers. Choose this if you have an Epson or Star receipt printer.

PHP (Legacy)

Server-side PHP templates using WooCommerce functions. Kept for backward compatibility with existing theme overrides. Requires a server connection to render.

The template gallery at WP Admin > POS > Templates provides ready-to-use starter templates you can install and customise:

TemplateEngineDescription
Standard ReceiptHTMLDefault receipt layout
Detailed ReceiptHTMLExtended layout with more line item detail
Branded ReceiptHTMLA4-friendly layout with store logo and branding
Gift ReceiptHTMLPrices hidden, suitable for gift purchases
InvoiceHTMLInvoice format for business customers
Tax InvoiceHTMLInvoice with fiscal fields for tax compliance
Thermal Simple (58mm)XMLClean layout for 58mm thermal printers
Thermal Simple (80mm)XMLClean layout for 80mm thermal printers
Thermal Detailed (80mm)XMLExtended thermal with tax breakdown and barcodes
Kitchen TicketXMLItems only, large font, no pricing — for kitchen prep

Browse by category (receipt, invoice, gift receipt, credit note, kitchen ticket) and format (HTML browser print / ESC/POS thermal).

How It Works

  1. Install a template from the gallery or create your own
  2. Customise it using the in-app editor with live preview
  3. Set it as active — the first template in your list is the default
  4. Print or display — receipts render after checkout, with options to print, email, or view on screen

Templates use a standardised receipt data payload with sections for store info, line items, totals, tax, payments, and more. All currency fields include pre-formatted _display variants for easy use in templates.

Pro Features

With WCPOS Pro, you can assign specific templates to individual stores. Each store can have its own receipt branding (logo, address, contact details) and its own template selection and ordering.

In This Section