Hi. How can we help?

Setting up secondary receipts for Retail POS (X-Series) on iPad


Due to technical limitations on Mac and PC that dictate only one printer can be used at a time, Retail POS's secondary receipt function is only supported on iPad.


Secondary receipts are those set up to print from a second, separate receipt printer at the time of sale.

The intended use for these is typically kitchen or barista printing, allowing you to print specific transactions or specific transactions containing a pre-set group of products, in order to generate an 'order'.

You can have more than one secondary receipt printer, and each can have its own tag settings that dictate what sales are printed.

How to set up a secondary printer

Set up your Printer Hardware:

Supported printers
Star TSP 100 (143) LAN
Star TSP100III (Wireless)
Star TSP100III (USB)
Star TSP100III (Bluetooth)
Star 650II BTI (Bluetooth)
Star mC Print 2 (3)
Star SM-S230i (Bluetooth)
Star mPOP (Bluetooth)

Epson TM-T82II (Ethernet)
Epson TM-m30 (Ethernet)
Epson TM-m30 (Bluetooth)
Epson TM-T88V
Epson TM-T88VI

Configure the printer for secondary receipts:

1. Tap the Menu icon (☰) and tap Settings


2. Tap Hardware


3. Under Receipt printers, select the printer that you wish to print secondary receipts from


4. Tap Receipt type

secondary receipt template with tags

5. Select Secondary receipt

Product tags

A secondary receipt does not have a header or payment details. When printing to a secondary receipt, you can choose only to print items with a certain tag, for example, "coffee" and "tea", or "food". 

  • Tags are lower-level categories that the product belongs to. Tags are used for product grouping to optimize filtering and searching. These are added to a product when creating or editing a product. Tags can be made up of letters, numbers, and symbols.
  • To add tags, navigate to Catalog > Products, select the product tags are to be added to, and click Edit

After you set the receipt type to Secondary receipt, the Print products by tag field will appear. This allows you to specify which product tags will cause a secondary receipt to be generated by the printer only when a product with that tag is included in the sale.

1. Tap the Print products by tag toggle button
2. A new field called Tags will appear. You can add different product tags and each tag should be separated by a comma.
3. Set Cash drawer enabled to Off  to prevent triggering the cash drawer for a secondary receipt


These tags must exactly match the tags you added when you set up your products. You can check these by logging into the Retail POS on Mac or PC, and clicking the products tab. You can then either look at individual products or use the 'tags' tab to see what you've already got set up. If you want to know more about setting up tags on products, read this article.

Now, when you make a sale with a tagged product, this receipt printer will generate a receipt as well as your main printer.


You could tag all your coffee products in a café with "barista" and all the items that need to be sent to the kitchen with "kitchen".

When setting up the printer in the barista area, you'd specify the "barista" tag. When setting up the printer in the kitchen, you'd select the "kitchen" tag.

If 1 x coffee and 1 x eggs on toast is sold, the following receipts will be printed:

  • Main printer - a sale receipt with all items, to be given to the customer
  • Barista printer - a receipt with only the coffee, so the barista can process the order
  • Kitchen printer - a receipt with only the eggs on toast so that the kitchen can prepare it

The following items will be printed on a secondary receipt:

  • Invoice number
  • Date
  • User
  • Products, including variants (provided they match the tags specified)
  • Discounts
  • Line item notes


You can print both a standard receipt and a secondary receipt(s) to the same printer. Just add the same printer twice, and choose standard receipt the first time, and secondary receipt the second time. The printer will then print a full receipt, and the secondary receipt slip on applicable sales.

Was this article helpful?