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.

Feature flag required

The Customer Display requires enable_customer_display to be enabled. Toggle it under Settings > Edit Settings > Hardware & System tab in the Customer-Facing Display section.

What It Shows​

Idle State​

When no transaction is active, the display shows a configurable idle screen. Settings are available under Settings > Edit Settings > Hardware & System > Customer-Facing Display:

  • Featured Products — show a grid of products sourced from: Featured, Best Sellers, New Arrivals, or On Sale.
  • Custom Message — display a custom text message.
  • Default: store name welcome message.

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​

URL​

The Customer Display is accessible at:

https://yourstoreurl.brotherpos.ca/customer-display

Alternatively, append ?display=customer to the POS URL:

https://yourstoreurl.brotherpos.ca/pos?display=customer

Hardware​

Connect a secondary monitor, tablet, or TV to your POS terminal (or use a separate iPad/tablet on the same network). Open the Customer Display URL in a browser on the secondary device.

Enabling​

  1. Enable enable_customer_display under Settings > Edit Settings > Hardware & System tab.
  2. Open the Customer Display URL on your secondary device.
  3. The display subscribes to real-time updates via ActionCable and stays in sync with the register automatically.

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.