> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duitpos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Barcode Scanning

> Scan or type a barcode from anywhere in the app

DuitPOS listens for barcode input **in the background**, from anywhere in the app — you don't need to click into a search box first.

## How it works

* A connected barcode scanner can be aimed and triggered at any time, on any screen, and the app will pick up the scan automatically.
* If you don't have a physical scanner, you can **manually type the barcode digits** on your keyboard followed by **Enter**, and the app treats it exactly like a scan — again, without needing to click into any specific field first.

<Tip>
  This works even if your cursor or focus is somewhere else on the screen — you don't need to be inside a search bar or any input field for a scan (or typed + Enter) to register.
</Tip>

## What happens when a barcode is scanned

* If the barcode matches a known product, that item is added to the current cart automatically.
* If the product has variants or modifiers, you may be prompted to choose them, same as tapping the item manually.
* If no match is found, the app will show a "not found" message rather than silently doing nothing.

## When this is useful

* Quickly ringing up packaged items without searching the menu grid
* Speeding up checkout for high-volume retail-style items
* Working from any screen — you don't need to navigate to a specific "scan" screen first

<Note>
  If scanning doesn't seem to register, confirm your barcode scanner is properly connected/paired, or that you're pressing Enter after manually typing the code.
</Note>