SecondaryScreen

SecondaryScreen

Secondary Screen (Customer-Facing Display)

A product-knowledge guide for support and internal staff.

1. What is it?

The Secondary Screen turns a second display — connected to the iPad by cable — into a customer-facing screen. While the cashier keeps working on the iPad as normal, the customer looks at their own screen showing the order, the amount to pay, a payment QR code, or a welcome image/video from the merchant.

Think of it like the small screen you see facing you at a supermarket checkout: the staff use their till, you see your own items and total.

2. Why merchants use it

  • Transparency & trust — customers watch items and prices appear as they're rung up, which reduces disputes ("that's not what I ordered").
  • Branding & promotion — when there's no active order, the screen shows the merchant's own welcome image or video (logo, promo, menu highlights).
  • Faster payment — for DuitNow, the QR code shows on the customer's screen so they can scan and pay without the cashier turning the iPad around.

3. What it can show

The customer screen automatically switches between these views — the cashier doesn't manually change it:

What the customer sees When it appears
Welcome screen — the merchant's image or video, with a "Welcome" message No active order (idle / standby), or the cart is empty
Order screen — the live list of items, quantities, and running total While the cashier is adding items to the cart
Payment screen — the total and amount tendered While the cashier is taking payment
DuitNow QR code While a DuitNow payment is in progress, so the customer can scan it

4. Hardware & requirements

  • An iPad running iPadPOS.
  • A second display — a monitor or customer-display screen.
  • A wired connection: USB-C or HDMI, with the appropriate adapter/cable for the iPad model.
  • The "Use external display as secondary screen" setting must be turned ON (see Setup below).

5. Setup — step by step

All settings live under Settings → Device Settings. Guide the merchant there first.

Step A — Turn the feature on

1. Open Settings in iPadPOS.

2. Go to the Device Settings section.

3. Find "Use external display as secondary screen" and switch the toggle ON.

Step B — Connect the display

1. Plug the second screen into the iPad using the USB-C / HDMI cable and adapter.

2. The customer view appears on the second screen automatically. (If the setting in Step A was off when the cable was plugged in, turn it on and reconnect the cable — see Troubleshooting.)

Step C — Set the welcome image or video (optional but recommended)

This is the picture or video customers see when there's no active order.

1. In Settings → Device Settings, tap "Asset Folder".

2. Tap "Browse Folder" at the top-right.

3. Pick an image or video from the iPad's files.

  • Allowed file types: PNG, JPG, JPEG (images) or MP4 (video).

4. The chosen media becomes the welcome-screen background on the customer display.

Step D — Adjust the text size (optional)

1. In Settings → Device Settings, tap "Configure Font Size".

2. A live preview appears on the customer screen — drag the slider and watch the text on the second screen grow or shrink.

3. Tap Done to save, or Cancel to discard.

6. Good to know / limitations

  • Turn the setting on before connecting, or reconnect after turning it on. The app decides whether to use the second screen at the moment the cable is connected. If the setting was off then, plugging back in (or toggling the setting) fixes it.
  • Empty order = welcome screen. If the cart has no items, the customer screen shows the welcome screen rather than a blank order — this is intended.
  • Supported media only: PNG, JPG, JPEG, MP4. Other file types (e.g. GIF, MOV, PDF) won't display.
  • Welcome media is per-outlet. Switching outlets can change what shows on the welcome screen.
  • Works offline and in any mode. The customer screen is purely a local display — it doesn't need internet, and it behaves the same on server, client, or standalone iPads.

7. Troubleshooting

Symptom Check Fix
Nothing shows on the second screen Is "Use external display as secondary screen" turned ON? Turn it ON, then unplug and re-plug the display cable. The app only starts the customer view when the cable connects with the setting already on.
Screen is blank / black Is the cable fully seated? Was the display unplugged and plugged back mid-use? Reseat the cable. If it went black after a brief disconnect, unplug and reconnect once more. Also confirm the adapter/cable supports video output for that iPad.
Welcome image/video won't update Was a new file picked via Asset Folder → Browse Folder? Is it a supported type (PNG/JPG/JPEG/MP4)? Re-pick a supported file. Remember media is per outlet — confirm you're on the right outlet.
Text is too small / too large — Use Settings → Device Settings → Configure Font Size and adjust with the live preview.
DuitNow QR not showing on customer screen Is a DuitNow payment actually in progress on the iPad? The QR only appears during an active DuitNow payment. If the cashier isn't at that step, it won't show.

8. FAQ

Q: Does the customer screen need its own internet or app?
No. It's just a display driven by the iPad. No separate app, login, or connection.

Q: Can I use a wireless (AirPlay) screen?
It can work — the app handles AirPlay like a wired screen — but for a checkout counter, wired (USB-C/HDMI) is recommended for reliability.

Q: Can each outlet have a different welcome image?
Yes. The welcome image/video is saved per outlet.

Q: The cashier's iPad looks normal — is that right?
Yes. The cashier always keeps the full cashiering screen; only the second display shows the customer view.

Q: What file types can I use for the welcome screen?
Images: PNG, JPG, JPEG. Video: MP4.

Q: Do I have to switch the customer screen between "order" and "payment" manually?
No. It switches automatically as the cashier adds items, takes payment, or clears the order.

    • Recent Articles

    • How to create stock request in Xilnex Classic

      Stock Request Stock Request is the function allowing the outlets to make request stocks from HQ or other outlets. Basic Stock Request Go to Inventory > Stock Request Select Request Stock From outlet. Select ETA (Expected Time Arrival) if any. a) Add ...

    • Coming Soon: Promotion Hierarchy

      What is Promotion Hierarchy? Promotion Hierarchy is a new feature in the Xilnex Portal that allows users to define promotion eligibility by combining multiple item attributes within a single rule. Instead of creating multiple separate promotion ...

    • SecondaryScreen

      Secondary Screen (Customer-Facing Display) A product-knowledge guide for support and internal staff. 1. What is it? The Secondary Screen turns a second display — connected to the iPad by cable — into a customer-facing screen. While the cashier keeps ...

    • PaymentTerminal

      Payment Terminal (Card Machine Integration) A product-knowledge guide for support and internal staff. 1. What is it? A payment terminal is the card machine a customer taps, inserts, or swipes their card on. iPadPOS can connect to a payment terminal ...

    • OutOfStock

      Out of Stock (Marking Items Unavailable) A product-knowledge guide for support and internal staff. 1. What is it? Out of Stock (OOS) lets a cashier mark a menu item as temporarily unavailable — the "we've run out" / "86'd" button. Once an item is ...

    • Popular Articles

    • Basic - How to create a voucher-coupon

      Voucher and coupon definition Voucher can be generated in bulk and can be used once Coupon can only be created one at a time (reusable code) and can be use multiple times Pre-voucher / coupon setup There are 2 things need to be prepared before we can ...

    • Understanding DuitNow QR Payment in ClassicPOS

      Introduction This document introduces the DuitNow QR payment feature available in the Xilnex Retail POS, enabling merchants to accept payments conveniently through Malaysia's national QR payment standard. The integration of DuitNowQR simplifies the ...

    • Intermediate - How to Configure and Use Approval Settings in Purchase Orders (PO)

      1.0 What is approval setting In general, "approval setting" refers to the configuration or process by which a request, action, or change must be reviewed and approved before it proceeds. The term is often used in business, software applications, and ...

    • Buy 2 for Special Price Promotion

      Use Case: Stock clearance, seasonal offers, or spotlight products. From the sample screenshot above, this promotion requires 2 items to trigger. If only 1 Milk Tea is added to the sales list, no discount will apply since the condition of 2 items is ...

    • Creating Delivery Type for Sales in Classic POS

      How to Create Delivery Type 1. Access to the [System Configuration] 2. Select the [Sales] section 3. In the [All Outlets] tab, look for the 'Delivery Type' 4. Click on the [Configure] In the Delivery Type Setup form: 1. Enter the Delivery Type. 2. ...