## ⚙️ Product Display Settings

Controls how products appear on the POS ordering screen — size, images, names, and search behavior. (A single **Layout** section adds an item-name layout option alongside these.)

### 📝 How to configure
1. Tap the **Settings** icon in the left sidebar
2. Select the **General Settings** tab
3. Open the **Product** section
4. Adjust any of the following, then tap the green **Done** check to save:

| Option | What it does |
|---|---|
| **Item Display Size** | Sets the size of product tiles in the POS grid — smaller sizes pack more items onto each screen. |
| **Show Item Image** | When on, product tiles show the item's photo; when off, tiles fall back to the item's colour swatch. |
| **Show Item Name** | Toggles whether the item name label is drawn on the product tile in the POS grid. |
| **Quick Category Mode** | Controls the quick-category behaviour on the POS. |
| **Show Item Alias** | Displays the item's alias (short code) on the POS tile in place of the full name. |
| **Enable Codename Search** | Enable codename search in POS |
| **Show Codename Badge** | Display product codename badge on the top-left of product buttons |
| **Codename Badge Color** | Background color of the codename badge (hex, e.g. #FF2F00) |
| **Item Name Font Size** | Font size for product name display (8-32px) |
| **Item Name Background Opacity** | Background opacity for product name when image is shown (0-100%) |
| **Category Button Shape** | Category button layout: square (default), compact (smaller), rectangle (more per row) |
| **Modifier Single Select** | Hide modifier quantity buttons so each modifier can only be selected once |
| **Hide Barcoded Items** | Items with a barcode are hidden from the menu grid; search and barcode scanning still find them |
| **Layout Item Name** | Layout Item Name (found in the separate **Layout** card on the same tab) |

---

## 🎬 Video Guide

[Watch Demo Video](https://support.agenteehq.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBc3dDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--73f177617df8b79a401d89bf4d916ae1ccff0e13/product-display-settings-EN.mp4)