# Receipts

WCPOS includes a complete template system for receipts, invoices, gift receipts, packing slips, kitchen tickets and more — all managed in **WP Admin → POS → Templates**.

Just want to change your receipt?

Start at **[Customise Your Receipt](/receipts/customise.md)**. It walks through the three easiest ways to do it — picking a different bundled template, asking AI to tweak one, or editing by hand.

## Template engines[​](#template-engines "Direct link to Template engines")

WCPOS supports three template engines. The engine is chosen when you create a template or click **Use Template** on a gallery card, and **cannot be changed afterward** — start a new template if you want to switch engines.

#### Logicless HTML (recommended)

Mustache-style `{{variable}}` placeholders inside plain HTML. Renders client-side, so receipts **work offline**. Use for browser print and PDF receipts.

#### Thermal XML

XML templates that produce both a screen preview and **ESC/POS commands** for thermal receipt printers. Same template, two outputs. Use for Epson, Star, and other thermal printers.

#### Legacy PHP

Server-side PHP templates using WooCommerce functions. Kept for backward compatibility with existing `yourtheme/woocommerce-pos/receipt.php` overrides. Requires a server connection to render.

## Template gallery[​](#template-gallery "Direct link to Template gallery")

The gallery ships with ready-made templates you can use as-is or customise. Filter by **category** (Receipt, Invoice, Gift Receipt, Kitchen Ticket, Quote / Purchase Order), **format** (HTML / ESC/POS), and **direction** (LTR / RTL); preview with your store's real data. Each card's footer has a **Preview** link and a primary **Use Template** button — clicking Use Template creates an editable copy in *Your Templates*.

### HTML templates[​](#html-templates "Direct link to HTML templates")

For browser print and PDF receipts. Render client-side, so they work offline.

#### Standard Receipt

**HTML** · Default receipt — logo, store identity, items, totals, payment.

#### Standard Receipt (RTL)

**HTML · RTL** · Right-to-left counterpart for Arabic, Hebrew, Persian, Urdu.

#### Minimal / Modern

**HTML** · Same essentials as Standard, packed into less vertical space.

#### Detailed Receipt

**HTML** · Full tax invoice — SKU column, unit price, per-rate tax breakdown, addresses.

#### Gift Receipt

**HTML** · Items only, prices hidden. Includes gift message and return policy.

#### Invoice

**HTML** · Full-page A4/Letter invoice with optional "How to pay" panel for unpaid orders.

#### Packing Slip

**HTML** · Warehouse companion — items + quantities, ship-to, no prices.

#### Quote / Estimate

**HTML** · Pre-sale document with pricing and terms — no payment section.

#### Narrow Receipt

**HTML** · Monospace receipt for narrow paper or HTML-capable thermal printers.

### Thermal (ESC/POS) templates[​](#thermal-esc-pos-templates "Direct link to Thermal (ESC/POS) templates")

For Epson, Star, and other thermal receipt printers.

#### Simple Thermal Receipt (58mm)

**Thermal · 58mm** · Clean 58mm thermal layout.

#### Simple Thermal Receipt (80mm)

**Thermal · 80mm** · Clean 80mm thermal layout — most common.

#### Simple Thermal Receipt 80mm (RTL)

**Thermal · 80mm · RTL** · RTL counterpart for 80mm. Needs a printer with an Arabic codepage (CP864 / Windows-1256).

#### Detailed Thermal Receipt (58mm)

**Thermal · 58mm** · Kitchen-sink 58mm — addresses, tax breakdown, refunds, payments, terms, barcode.

#### Detailed Thermal Receipt (80mm)

**Thermal · 80mm** · Kitchen-sink 80mm — addresses, tax breakdown, refunds, payments, terms, barcode.

#### Kitchen Ticket

**Thermal** · Items only, large font, no pricing — for prep stations.

### Third-party document templates[​](#third-party-document-templates "Direct link to Third-party document templates")

If **PDF Invoices & Packing Slips for WooCommerce** by WP Overnight is active, WCPOS also exposes **Invoice (WP Overnight)** and **Packing Slip (WP Overnight)** in the receipt template list. These server-rendered HTML templates delegate to WP Overnight's document API, reusing the invoice and packing-slip numbering, layout, branding, legal/tax fields, and template customisations configured in that plugin.

They are available only while the WP Overnight plugin is active and require a server connection to render. Use WCPOS's bundled HTML or thermal templates when offline printing is required.

### Adaptive tax display[​](#adaptive-tax-display "Direct link to Adaptive tax display")

Most bundled templates (Standard, Standard RTL, Minimal/Modern, Narrow, Invoice, Quote, Thermal Simple variants) **adapt automatically to your WooCommerce tax-display setting**:

* **Tax-inclusive stores** (EU/UK/AU) see gross prices with a "Tax included" line.
* **Tax-exclusive stores** (US/CA) see net prices with tax added as a separate line.
* The grand total always shows the gross amount actually charged.

The **Detailed** family is a formal tax invoice and always itemises tax with tax-exclusive lines plus an explicit breakdown, regardless of the store setting.

## How it works[​](#how-it-works "Direct link to How it works")

1. **Add a template** — click **Use Template** on a gallery card, or create your own from scratch.
2. **Customise it** using the in-app editor with live preview, or paste it into ChatGPT / Claude and ask for the changes you want.
3. **Activate it** — flip the **Active** toggle in *Your Templates*. Every active receipt template appears in the receipt-screen dropdown at the till.
4. **Print or display** — receipts open after checkout with options to print, email, or view on screen.

Templates render against a standardised [receipt data payload](/receipts/receipt-data.md) with sections for store info, line items, totals, tax, payments, refunds, and more. Currency fields all include pre-formatted `_display` variants (e.g., `$29.99` instead of `29.99`).

## Pro features[​](#pro-features "Direct link to Pro features")

With [WCPOS Pro](/getting-started/pro-license.md), each store can have its own template assignments, branding (logo, address, contact details), and template ordering — useful for multi-location operations where each shop prints its own letterhead.

## In this section[​](#in-this-section "Direct link to In this section")

[Customise Your ReceiptThe easiest way to change how your WCPOS receipt looks — pick a different template, ask AI to tweak it, or edit it by hand.](/receipts/customise.md)

[HTML TemplatesCreate and customise logicless HTML receipt templates using Mustache-style placeholders.](/receipts/html-templates.md)

[Thermal TemplatesCreate XML-based receipt templates for ESC/POS thermal printers with Epson and Star support.](/receipts/thermal-templates.md)

[Receipt DataComplete reference for the canonical data contract available in WCPOS receipt templates.](/receipts/receipt-data.md)

[Cloud PrintingPrint WCPOS receipts to printers that aren't attached to the till — Star Online, Star CloudPRNT, Epson Server Direct Print, and PrintNode.](/receipts/cloud-printing.md)

[ReceiptsPrint and email receipts in WCPOS, including printer setup and receipt customisation options.](/receipts/at-checkout.md)