# Customer Display

A customer display is a second screen that faces the customer, such as a tablet or a monitor with a web browser. It shows the cart as you ring it up, line by line, with the total.

Pro Feature

Customer displays need WCPOS Pro. Without it, **Settings → Customer Display** says so: see [Free vs Pro](/zh-CN/getting-started/free-vs-pro.md#customer-display).

Each display is paired with one till, and that till sends it the cart directly. Keep the till and the display on the same Wi-Fi network: guest networks often block the link between them.

## Pair a display[​](#pair "直接链接到 Pair a display")

You need the till and the display device side by side. A pairing code works once and expires after 10 minutes.

1. **On the till**, tap **Settings** at the bottom of the side menu, then **Customer Display**.
2. **Tap Generate pairing code.** A six-digit code appears, with when it expires.
3. **On the till, note the address.** **Display page URL**, under the button, is your site's address followed by `wcpos-display/`. On a till that runs in a web browser, **Copy URL** copies it, to send to the display device.
4. **On the display device, open that address.** The page reads **Pair this display**.
5. **Enter the code.** Type the code in **Pairing code**, change **Display name** if you like (it starts as *Customer display*), and tap **Pair display**.
6. **Check the till.** The display appears under **Paired displays** and reads **Connected**. Add a product to the cart: it shows on the display. If the display shows a message instead, see [If something goes wrong](#troubleshoot).

On a till that runs in a web browser, **Open in browser**, beside **Copy URL**, opens the display page in a new tab on the till itself, not on the display device.

![Settings, Customer Display on the till: a six-digit pairing code that expires in 10 minutes, the Generate pairing code button, the Display page URL with Copy URL and Open in browser, and an empty Paired displays list](/img/2.x/hardware/customer-display/en/tablet-light-regular--cd-1-pairing-code.png)12345

1. **Customer Display** — in **Settings**, after Card readers.
2. **The pairing code** — type it on the display. One code pairs one display.
3. **Generate pairing code** — makes a new code. Tap it again if the code expires before you use it.
4. **Display page URL** — the address to open on the display, with **Copy URL** and **Open in browser** on a till in a web browser.
5. **Paired displays** — reads *No displays are paired with this device.* until a display enters a code.

To fill the screen, use the browser's full-screen mode on the display device. The browser remembers the pairing: reopen the same address in the same browser and the display reconnects, with no new code.

## Paired displays[​](#paired-displays "直接链接到 Paired displays")

**Paired displays** lists the displays paired with this till. Each row shows the display's name, when the till last saw it, and **Connected** or **Disconnected**.

![Settings, Customer Display with one display under Paired displays: Counter display, last seen less than a minute ago, Connected, and its menu button](/img/2.x/hardware/customer-display/en/tablet-light-regular--cd-2-paired.png)12

1. **Connected** — the display named *Counter display* is linked to this till right now. **Disconnected** means the display page is closed or can't reach the till.
2. **⋮** — the row's menu, with **Forget**.

A display shows one till's sales. To give each counter its own screen, pair a display on each till.

## What the customer sees[​](#what-the-customer-sees "直接链接到 What the customer sees")

What the display shows comes from its template. **Ledger**, the default display template, lists the items with a totals panel beside them on a wide screen, and docks the total at the bottom of a narrow one. With Ledger:

* **Between sales**: the store's logo, or its name if it has no logo, and a welcome line.
* **During a sale**: each line with its quantity, name and line total under **Your items**, and a panel with **Subtotal**, any fees, shipping, discounts and tax, then **Total**. When the customer saves money on the sale, it adds **You saved**. When a customer is attached to the order, it greets them by first name.

The display follows the sale through payment.

The logo is the store's own: the one on the store's **Details** page, which also prints on receipts. A store that uses the site logo shows your WordPress site logo. See [Store setup](/zh-CN/stores/setup.md#store-pages).

## Choose the template[​](#template "直接链接到 Choose the template")

Every display shows the site's **Live** display template, unless its store picks its own. A display picks up a change within about a minute, with no new pairing.

Change the template for all stores

1. In WP Admin, go to **POS → Templates** and open the **Display** tab, next to the receipt templates.
2. Turn on **Enabled** for the template you want.
3. Select it in the **Live** column.

The gallery itself is covered in [Reports, closures and customer displays](/zh-CN/receipts.md#other-templates).

Change the template for one store

1. In WP Admin, go to **POS → Stores**, click the store, then **Customer display** in its menu.
2. Under **Display template**, which reads **Same as site**, click **Customise**.
3. Pick a template. The list holds the templates enabled on the **Display** tab. The page saves as you go.

**Use site template** puts the store back on the site's **Live** template.

## Forget a display[​](#forget "直接链接到 Forget a display")

To unpair a display, open **⋮** on its row under **Paired displays** and choose **Forget**, then **Forget** again to confirm. The display page then reads *This display was removed. Pair it again.* To use that screen again, [pair it](#pair) with a new code.

![The menu of a paired display open, with Forget](/img/2.x/hardware/customer-display/en/tablet-light-regular--cd-3-forget-menu.png)1

1. **Forget** — removes the display from this till. It needs a new pairing code before it shows this till again.

## If something goes wrong[​](#troubleshoot "直接链接到 If something goes wrong")

### Pairing[​](#troubleshoot-pairing "直接链接到 Pairing")

That pairing code is invalid or expired.

Codes last 10 minutes and work once. Tap **Generate pairing code** on the till and type the new one. After several wrong codes the page reads *Too many attempts. Try again shortly.*: wait a moment before trying again.

The Generate pairing code button is greyed out.

The page reads *The customer display service is not running on this device.* Reload the POS, and if it stays greyed out, check **Logs** for the reason.

Customer displays need a newer version of WCPOS Pro.

The Pro plugin on your site is older than customer displays. Update WCPOS Pro in WordPress, then reload the POS.

This display was removed. Pair it again.

Someone chose **Forget** for this display on the till. [Pair it](#pair) with a new code.

### Connection[​](#troubleshoot-connection "直接链接到 Connection")

When a display can't connect for 30 seconds, it says why on its screen and keeps trying.

This display can't reach the POS on this network.

The display reached your store but not the till. Put both devices on the same Wi-Fi network. Guest networks often keep devices apart, so use your shop's main network.

This display can't reach your store.

The display device has no internet connection, or can't reach your site. Check its Wi-Fi, then reload the display page.

Waiting for the POS.

The till this display is paired with isn't running. Open the POS on that till.

The POS answered but didn't finish setting up this display.

Restart the POS on the till and try again.

### What the display shows[​](#troubleshoot-content "直接链接到 What the display shows")

No customer display template is configured.

No display template is enabled. Enable one on the **Display** tab in **POS → Templates**.

The display shows the welcome screen during a sale.

The picture of the cart couldn't be built, logged as [DISPLAY101](/zh-CN/error-codes/DISPLAY101.md). Carry on with the sale: the display catches up the next time the cart changes.

### Still stuck?[​](#still-stuck "直接链接到 Still stuck?")

[Discord Community](https://wcpos.com/discord)<support@wcpos.com>

## Related Documentation[​](#related-documentation "直接链接到 Related Documentation")

[Store setupEach store's logo and its Customer display page, where a store picks its own display template.](/zh-CN/stores/setup.md)

[Receipts and templatesThe template gallery, where the Display tab holds the customer display templates.](/zh-CN/receipts.md)

[Free vs ProWhat the free plugin covers, and what needs WCPOS Pro.](/zh-CN/getting-started/free-vs-pro.md)
