Skip to main content

Customer Display

The Customer Display is a real-time secondary screen that shows customers what's being rung up during checkout. It connects to the POS via ActionCable (WebSocket) and updates instantly as items are added, removed, or modified.

What It Shows​

Idle State​

When no transaction is active, the display shows a welcome message with the store name.

Active Cart​

During a sale, the display shows:

  • Line items with product names and prices
  • Subtotal before tax
  • Discounts (item-level, order-level, loyalty, promo, and qualifying discounts)
  • Tax breakdown (single rate or split GST/PST depending on store configuration)
  • Freebie progress — progress bars showing how close the customer is to earning a free item
  • Total due

Promo Games​

If promo games are enabled, the customer display can show:

  • Game selection screen
  • Active game animation
  • Win/loss results with reward details

Setup​

Hardware​

Connect a secondary monitor or TV to your POS terminal. Open a browser window on the secondary display and navigate to the Customer Display URL.

Enabling​

The Customer Display works automatically when the POS is running. It subscribes to real-time updates via ActionCable and stays in sync with the register.

Multi-Tenant​

In multi-tenant mode, each store's customer display is isolated — broadcasts are scoped to the store's tenant stream.

How It Works​

  1. The POS register broadcasts cart state changes over ActionCable
  2. The Customer Display receives updates in real-time
  3. Items, totals, discounts, and taxes update instantly
  4. When the sale is completed, the display returns to the idle/welcome state

No manual configuration is needed — the display automatically connects and syncs.