Enable Stock Display in POS Settings

Navigate to Point of Sale → Configuration → Settings (or open the POS configuration form directly). Under the "Display Stock in POS" setting, check the box to enable it. Once activated, additional stock configuration options will appear — including Stock Type, Stock Location, Low Stock Threshold, Badge Position, and the Deny Order option. Save the settings to apply your changes.

Configure Stock Type & Location

Choose the Stock Type to display: select "Quantity On Hand" for actual physical stock or "Forecasted Quantity" to include incoming and outgoing shipments. Next, select the Stock Location source — pick "All Warehouses" to aggregate stock across all locations, "Current Warehouse" to use the warehouse linked to this POS, or "Specific Location" and choose an internal stock location from the dropdown.

Set Low Stock Threshold & Badge Position

Enter a Low Stock Threshold value (e.g., 5). Products with stock at or below this number will display an orange warning badge on their product card. Set the Badge Position to control where the stock quantity badge appears — choose from Top Right, Top Left, or Bottom Right. Optionally, enable "Deny Order if Out of Stock" to prevent cashiers from adding storable products with zero stock to the order.

View Stock Badges on POS Product Cards

Open a POS session and navigate to the product screen. Each product card now displays a color-coded stock badge showing the available quantity. A green badge indicates sufficient stock, an orange badge warns of low stock (at or below your threshold), and a red badge signals zero or negative stock. If the "Deny Order" option is enabled, tapping an out-of-stock storable product will show a warning and prevent it from being added to the order.

Refresh Stock Manually or Automatically

After completing and validating a POS order, stock quantities on product cards automatically refresh to reflect the latest inventory. You can also click the Refresh Stock button (🔄) in the POS navbar at any time to manually update all product stock data — useful when inventory changes happen outside the POS, such as warehouse receipts or internal transfers.

Total Items Count on Printed Receipt

When a POS receipt is printed, the module automatically adds a "Total Items" line just above the receipt total. This gives customers and cashiers a quick summary of the total number of items in the order — making it easier to verify the order at a glance without counting individual lines.