Register layout and assortment

Which items appear on the touch register, in what order, at what size, and with which colors is entirely merchant-controlled. The assortment is filtered server-side, so back-office-only items never even reach the browser. This page covers the configuration; the cashier-side tour of the surface is in Register tour.

Where it is configured

Assortment data lives on POS Items and POS Categories (Tell Me: POS Items, POS Categories), per-terminal display options on POS Terminals, and company defaults on the POS Setup card.

Assortment control

Field	Where	Default	What it does
Show on Register	POS Item	true	Only Active items with this flag render as tiles. Turn it off to keep an item sellable in the back office without cluttering the register.
Show on Register	POS Category	true	A hidden category removes both its tab and all its items from the register. Items with a blank (or dangling) category always show.
Register Sort Order	POS Item	0	Grid order within the category: sort order first, Description as tie-break.
Favorite	POS Item	false	Puts the item on the cross-category favorites strip above the category tabs.
Color	POS Category	Gray	Tile background from a fixed, legible palette (Gray, Blue, Green, Orange, Purple, Red, Teal, Slate) - a closed set by design.

Hidden categories are filtered server-side and never reach the register payload. An item hidden from the register can still be sold by barcode scan or from the back office. Catalog record details are on POS items and catalog.

Tile size and per-terminal display

Field	Where	Default	What it does
Tile Size	POS Setup	(Default) = Medium	Company-wide tile size: Small, Medium, or Large.
Show Favorites Row	POS Setup	off	Company-wide favorites strip.
Tile Size	POS Terminal	(Default)	Per-terminal override; (Default) inherits the POS Setup value.
Show Favorites	POS Terminal	Default	Yes / No per terminal; Default inherits POS Setup.

Tile color is per category and tile size is per company or terminal - there is no per-item color or size. Terminal records and the rest of their overrides are covered in Stores, terminals, and users.

How the register uses it

1. The cashier taps a category tab to filter (the All tab shows everything), then taps a tile to add one unit to the cart.
2. Tapping the same tile again increments the existing line's quantity, keyed on the item and variant pair.
3. Favorites render on the strip above the tabs with identical tiles, whatever category is active.

Item search behavior

The search box above the favorites strip needs no setup. It is deliberately two-stage: typed text filters the already-loaded tiles immediately, and from two characters a bounded, debounced server search returns up to 50 results ranked exact match, then prefix match, then contains match - so cashiers can find eligible items outside the current tile page. Search matches the POS item number, description, short description, legacy barcode, Business Central item number, extended text, variant code or description, unit of measure, and active Item Reference barcodes. Every selection is revalidated server-side against the register assortment, mapped-item saleability, blocked state, variant, unit of measure, and Item Reference identity before a line is added.

The barcode scan box below the grid is a separate input and remains the primary sell path - see Barcode scanning.

Stock badges on tiles

When Show Stock on Register is on in POS Setup, tiles show Low and Out badges against the store's location, with the threshold set by Low Stock Warning Qty. Badges are advisory only - an Out tile still sells. They require the POS item to be mapped to an inventory-type BC item and the store to carry a Location Code; otherwise no badge renders rather than a misleading zero. Details: Stock availability.

Quick tests

1. Turn Show on Register off for one item and reopen the register. Expected: the tile is gone, but the item still sells by scan.
2. Turn a category's Show on Register off. Expected: the tab and all its items disappear; blank-category items remain.
3. Set Register Sort Order 1 and 2 on two items. Expected: that order in the grid, with Description as tie-break for equal values.
4. Set one terminal's Tile Size to Large. Expected: larger tiles on that terminal only.