Text Layout

Print Message Structure

Receipts are built using simple XML-like tags that let you format and customize your printed output exactly the way you want.

✅ Compatible with ESC/POS printers and Expedy printers only.


Character limits

Each line has a maximum number of characters depending on the paper width used:

Paper width Max characters per line
58 mm 32 characters
80 mm 48 characters
  • A space counts as 1 character
  • A line break is automatically treated as a new line
  • Some ESC/POS printers may have different limits depending on font size and text encoding set in the printer firmware

Tags reference

<BR> — Line break

Hello<BR>John

<BOLD> — Bold text

<BOLD>Hello</BOLD>

<C> — Centered text

<C>Hello</C>

<CB> — Centered text + double height

<CB>Hello</CB>

<L> — Double height

<L>Hello</L>

<W> — Double width

<W>Hello</W>

<QR> — QR Code

Supports URLs, phone numbers, email addresses, and any text content.

<QR>https://www.example.com</QR>
<QR>tel:+12025550147</QR>
<QR>mailto:hello@example.com</QR>

Centered QR Code — tags can be combined:

<C><QR>https://www.google.com/maps/dir/?api=1&destination=Disneyland+Park,+Anaheim,+CA</QR></C>

<EAN> — EAN-13 Barcode

<EAN>0123456789012</EAN>

<IMG> — Image / Logo

Give your receipts a professional look by adding your company logo, a product image, or any custom visual — just drop in a URL. You can even print multiple images on the same receipt, swap your logo dynamically, or display a promotional banner and coupon code that change with every order.

<IMG>https://www.example.com/uploads/logo.jpg</IMG>

See the <IMG> documentation for format requirements and printer compatibility.


<PDF> — PDF Document

<PDF>https://www.example.com/document.pdf</PDF>

<CUT/> — Paper cut

Triggers the printer's automatic cutter.

<CUT/>

<PULSE/> — Cash drawer

Opens the cash drawer connected to the printer.

<PULSE/>