WooCommerce Integration

In your WordPress admin, go to Plugins → Add New, search for "ReceiptKit for WooCommerce", and click Install Now, then Activate— it's live in the WordPress.org plugin directory. For a manual install, download the plugin ZIP and upload it via Plugins → Add New → Upload Plugin. (Existing ZIP installs are the same plugin and receive updates automatically.)

After activating, a ReceiptKit item appears under the WooCommerce menu.

In your ReceiptKit dashboard, open API Keys and copy a public key (it starts with rk_pub_). A public key is safe to store in WordPress — it can print and read status, nothing more.

Then open WooCommerce → ReceiptKit, click the Settings (gear) button, paste the key into ReceiptKit public key, and choose Save & connect. The page confirms the connection and loads your printers and templates.

In your dashboard, open the Template Gallery and clone the WooCommerce starters you want. Each is pre-mapped to the exact field names the plugin sends, so they print correctly with no editing:

• WooCommerce Order – Customer Receipt — a branded receipt with items (incl. variations/add-ons), totals, payment, and the customer's note.
• WooCommerce Order – Packing Slip — a no-prices pick/pack slip with the ship-to address.
• WooCommerce Order – Kitchen Ticket — a large-format prep ticket for food orders, with modifiers highlighted and the pickup/delivery method up top.
• WooCommerce Order – Delivery/Pickup Ticket — a driver/handoff ticket with the fulfillment method and time slot huge at the top, plus customer phone and address.
• WooCommerce Order – Gift Receipt — items with no prices, an exchange-policy footer, and an order barcode for returns lookup.
• WooCommerce Order – Tax Invoice — seller VAT/ABN details and a per-rate tax breakdown, with an editable document title.
• WooCommerce Refund – Refund Receipt — a clear refund slip with the refunded items and amount.
• WooCommerce Order – Cancellation Slip — a cancelled-order slip with items and order total.

You can customize any template later in the template editor — the field mapping still applies.

Open any order. In the ReceiptKit box on the right, pick a template and click Print (or Previewto see it first). The plugin renders your template with the order's data right in your browser and opens the normal print dialog — choose your receipt printer and print. There is also a print icon in the orders list, a Print in browser sample button next to each rule on the settings page, and a refund selector for orders with refunds.

In the print dialog, choose the receipt printer as the destination, set the paper size to your roll width (80 mm or 58 mm — usually named "receipt" or "continuous"), set margins to none, and turn off headers and footers. Cutting and the cash drawer are controlled by the printer driver's own settings. On a dedicated counter PC, Chrome's --kiosk-printing flag prints straight to the default printer with no dialog.

Each order's ReceiptKit box also shows its print history— browser and automatic prints, who printed, and whether it succeeded. Browser prints are free and unlimited on every plan. If that's all you need, you're done; the next two steps are for printing with nobody at the computer.

Install the ReceiptKit bridge on the same network as your thermal printer and claim it. Run it on a Windows PC or Mac (PC Bridge Setup) or a Raspberry Pi (Raspberry Pi Bridge Setup) — whichever suits your counter. Once the printer shows up in your dashboard, it's selectable in your print rules, and receipts print silently the moment a rule matches.

On WooCommerce → ReceiptKit, the Print rules card is where you decide what prints, where, and when. The fastest way to start is "Start from a recipe" — a one-click preset that fills in a whole rule for you. Then just pick the template and printer.

Recipes included:

Every rule — whether from a recipe or built by hand — has three parts:

• When — the trigger: an order status change (e.g. → Processing, Completed, Cancelled), an order being refunded, an order being created, or manually from the order's Actions menu.
• If — optional conditions that narrow it down. Match ALL or ANY of tests like order total, payment method, coupon codes, item SKUs/names, country, whether it needs shipping, refund amount, and more. No conditions means it prints on every matching trigger.
• Then print to — the template and printer, plus an optional cash-drawer kick before and/or after printing.

You can add as many rules as you like — for example, a customer receipt to the counter printer and a packing slip to the back office from the same order. Rules save automatically as you edit.

Use Send test printto push a sample receipt to your printer and confirm the whole chain — WordPress → ReceiptKit → bridge → printer — works end to end. Then place (or transition) a real order to see your rules fire. Each print is recorded in the order's print history and as a note on the order, including the error if one occurs.

When does it print?

Browser printing is always manual: you click Print on an order. Automatic printing is driven by rules. A rule fires on its When trigger, then prints only if its If conditions match. The available triggers:

What's on the receipt

The plugin maps each order to these fields, which the WooCommerce templates already use. If you build your own template, use these field names.

Order & cancellation

Refund (on a refund trigger)

Troubleshooting