Plain-English summary#
Problems new users often hit in their first hour with Foodops — each with the symptom, the cause, and what to do. The most common ones: an item that isn't assigned to its outlet won't show on the POS, and the POS keeps its own copy of the menu until you refresh it (use the Refresh cached data icon in the counter's side menu).
Setup happens in two places: admin.foodops.io (catalog, settings, onboarding) and counter.foodops.io (the POS).
When you'd use this#
- Getting help while you're setting up
- Sorting out "I can't log in" or "my items aren't showing" yourself
- A checklist before a demo or before going live
Key concepts#
- Severity: High — stops normal work; you can't carry on without the fix
- Severity: Medium — something looks broken until you apply the fix
- Severity: Low — cosmetic or minor; annoying but you can ignore it
- Workaround — a fix you can apply yourself right now
- Cause — the actual reason behind the problem
Common questions#
Q: After signup I get a message saying I don't have permission to use the application — what do I do? A: Your name is now filled in from your email automatically, which fixes the usual cause. If you still see it, edit your user (Settings → Organization → Users), confirm the Name is set and grant the application/Owner role, save, and log out and back in.
Q: I created items but they're not showing on the POS counter. A: Most likely your outlet wasn't selected on the item (and/or its availability channel). In Catalog → Items, edit the item, tick your outlet and availability, save, then refresh the counter's cached data (the Refresh cached data icon in the side menu).
Q: I changed a menu group / its categories but it didn't save. A: Manage groups in Catalog → Menu Groups and Catalog → Categories in the admin app.
Q: My POS doesn't show a menu change I just made. A: The counter keeps a copy of the menu so it can work offline. Tap the Refresh cached data icon in the counter's side menu, confirm with Refresh, and wait for it to finish (you need to be online).
Q: The prices on my POS / till are wrong or out of date — how do I fix it? A: Same cause as the menu question above: the POS is still using the price list from before your change. Tap the Refresh cached data icon in the counter's side menu, confirm with Refresh, and wait for it to finish (you need to be online). The current prices then load. If one item is still wrong, check the price change was saved in admin.foodops.io and that the item is on the right price list and outlet.