mashgin

Kiosk

All of your kiosk learning and troubleshooting needs!

🚀 Getting Started

What is a Mashgin Kiosk?

A quick overview of what the Mashgin kiosk is and how it works.

How do I open Staff Mode?

How to open Staff Mode on a kiosk with a staff screen or a single screen, using the logo, a swipe, your passcode or a Manager Key card.

How to contact Mashgin Support?

The three ways to reach Mashgin Support: through the kiosk's Ask for Help screen, by phone/text, or by email.

What are some kiosk best practices?

A guide to maintaining your Mashgin kiosk — covering power cycles, cleaning, camera care, approved hardware, signage, and optimal placement strategies.

What is an LED indicator light pole?

An overview of the LED indicator light pole — what it does, what each color means, and what to do if it stops illuminating.

What is Staff Mode?

How staff use the Checkout, Transactions, Support and Manage tabs on the staff screen to fix carts, look up transactions and keep the kiosk running.

How can staff assist with transaction issues?

Handling Payment Issues

What are the basics of using and troubleshooting a kiosk?

An overview of how customers check out on a Mashgin kiosk, the most common customer mistakes, and quick troubleshooting tips for the messages you'll see at checkout.

What is the kiosk licensing system?

Overview of how Mashgin's kiosk licensing works, what happens when a license is invalid, and what to do if you see a licensing alert.

How Customers Ask for Help on the Kiosk

How customers can request staff assistance at a Mashgin kiosk using the Staff Assist button.

🔩 Hardware & Accessories

Kiosk Internal Cabling Guides

Internal cabling diagrams for Mashgin kiosk hardware versions v2.9 through v3.0.2. Use when performing internal hardware maintenance or cable replacement.

Kiosk External Cabling Guides

Visual reference diagrams showing external cable routing for Mashgin kiosks. Covers single-display and dual-display configurations.

What are the physical specifications of the kiosk?

Dimensions, weight, power requirements, and network specs for the Mashgin self-checkout kiosk and Side UX.

How do I install a rear CSR scanner?

Step-by-step instructions for installing a rear CSR scanner on a Mashgin kiosk.

How to Activate a CSR Scanner

Step-by-step guide to activating a CSR scanner.

How to Install a Printer

Step-by-step guide for setting up a new thermal receipt printer on a Mashgin kiosk, from unboxing through running a test print.

What are the kiosk visual standards?

Recommended kiosk, Side UX, and light pole placement to keep cameras unobstructed and the customer flow clear.

How do I install a kiosk scale?

Step-by-step guide to unboxing, leveling, connecting, and testing a Mashgin kiosk scale.

How do I enable the Staff Screen?

Step-by-step guide for enabling the Staff Screen on your Mashgin kiosk, on both the new Staff Mode layout and the older Manage Mode, including display identification.

How do I install a magnetic LED light pole?

Step-by-step instructions for mounting the magnetic LED light pole on the kiosk hood and connecting it via USB.

Kiosk and SideUX Disassembly

Step-by-step guide for safely disassembling the Mashgin kiosk and SideUX unit, including hardware removal, cable disconnection, and reassembly preparation.

What hardware is compatible with the kiosk?

A reference list of all peripheral hardware compatible with the Mashgin kiosk, including card readers, printers, scanners, RFID readers, and scales.

How do I add signage to the kiosk?

Explains the different signage options available for the Mashgin kiosk — including tower stickers and placement guides — and provides step-by-step instructions for applying them correctly.

🧹 Maintenance

How to Clean Your Kiosk

A step-by-step guide to safely cleaning the Mashgin kiosk base, cameras, camera covers, screen, and exterior — including what products to use and what to avoid.

How do I take care of the kiosk's cameras?

A guide to routine camera care — keeping covers clean, avoiding obstructions, and knowing when to escalate.

How do I tidy the kiosk's cables?

Use velcro ties and cable sheath to bundle and organize the cables at the back of the kiosk for a cleaner, less cluttered setup.

How do I load a roll of thermal printer paper?

Replace an empty thermal printer roll — open the cover, drop the new roll in, close it, and run a test print to confirm the printer is feeding paper.

How to Calibrate your kiosk

Guide for calibrating the kiosk’s cameras

📋 Items & Operations

How Do I Add a New Item with a Barcode?

Step-by-step guide to adding a new barcoded item to your Mashgin kiosk menu using Manage Mode.

What does the sync in progress message mean?

Explains what the Sync in Progress message means on the kiosk, how long to wait, and when to contact support if the message won't clear.

How to train items (Posing)

Learn how to pose (train) items on your Mashgin kiosk — including barcoded items, non-barcoded items, and tray posing — so they are recognized correctly at checkout.

What does the invalid code scanned alert mean?

Learn what causes the invalid code scanned alert on the kiosk and how to resolve it.

How do I reprint receipts on the kiosk?

Reprint a receipt from the kiosk using the Transactions tab in Staff Mode, or scan a QR code for a virtual receipt if printing is disabled at your location.

Can kiosks recognize large items?

How Mashgin kiosks handle large items: small items are recognized on the base, large items should be scanned via the barcode reader under the screen, and the staff screen Pick List is a fast alternative.

How do I enable age verification?

How to activate age verification on a Mashgin kiosk, choose the right verification flow, and tag menu items so age-restricted products trigger the verification process at checkout.

How to Hibernate the Kiosk

Step-by-step guide to closing or hibernating a Mashgin kiosk at the end of the day.

How do I update the kiosk's assigned location?

How to move a kiosk to a new location: get it online, then have Mashgin Support update its location and register it.

How do I refund transactions on the kiosk?

Step-by-step guide for processing full or partial refunds on the Mashgin kiosk, including how to locate a transaction and important refund limitations.

How do I assign a dotcode to an item on the kiosk?

A step-by-step guide to assigning a dotcode label to a menu item directly from the Mashgin kiosk manage mode.

What are voice alerts and how do I turn them on?

What kiosk voice alerts are, when the kiosk speaks them, and how to get them turned on for your location.

🌐 Network & Connectivity

Network Architecture Guide

Reference guide for IT and network teams — firewall allowlists, DNS and bandwidth requirements, local network rules, cloud security, and the site readiness checklist for Mashgin kiosks.

Understanding the Kiosk Network Test

Reference guide to the kiosk's built-in Network Test — what each check is verifying and how to read pass/fail results before troubleshooting.

How to Troubleshoot Network

Step-by-step troubleshooting for the Kiosk Offline alert — verify network settings, reconnect to grid, reseat or swap the ethernet cable, power cycle, and validate the network port.

🚨 Alerts

How do I resolve an expired license alert?

What a License Expired alert means and how to get the kiosk's license renewed by Mashgin Support.

How do I resolve a calibration issue alert?

Steps to clear a Calibration Issue alert on the Mashgin kiosk by running a full camera calibration.

How do I resolve an invalid license alert?

What an Invalid License alert means (a location mismatch) and how Mashgin Support re-registers the kiosk.

What is an alert?

Plain-language overview of kiosk alerts — what they look like in Manager Mode, why they appear, and how to dig into any specific alert from inside the kiosk UI.

How do I resolve a missing network configuration alert?

How to clear the Missing Network Configuration alert: check DHCP or Static IP in Staff Mode, run a Network Test, reconnect to Grid, reseat the cable and power cycle.

How do I resolve a NiCam issue alert?

Steps to clear a NiCam issue alert: power off from Staff Mode, unplug the kiosk and display, wait, and power back on.

What does the license expiration notification mean?

What the kiosk license expiration reminder means and how to get the license renewed by Mashgin Support before it runs out.

What do the kiosk network tests mean?

A reference for the 7 network tests the Mashgin kiosk runs from Manager Mode — what each test checks and what to do when one fails.

How do I resolve an inactive staff screen alert?

Troubleshooting guide for resolving the Staff Screen is Inactive alert, covering both unresponsive and responsive display scenarios.

What is the kiosk locked alert?

Learn what triggers the kiosk locked alert, how it affects sales, and how to resolve it by restoring internet connectivity.

How do I resolve a cameras cannot be reached alert?

Step-by-step guide for resolving a Cameras Cannot Be Reached alert by checking live camera feeds, identifying missing cameras, reseating cables, and power cycling the kiosk.

How do I resolve a Possible Blocked Cam alert?

How to identify and resolve a Possible Blocked Cam alert on your Mashgin kiosk.

How do I resolve a kiosk offline alert?

How to clear a kiosk offline alert: check network settings, run a Network Test, reconnect to Grid, reseat or swap the cable, and power cycle.

🔧 Troubleshooting

How do I power cycle the kiosk?

Step-by-step guide for power cycling (restarting) your Mashgin self-checkout kiosk to resolve common issues like frozen screens, camera alerts, and payment errors.

How do I reseat kiosk arm camera cables?

Step-by-step guide for reseating the USB camera cables on the kiosk arm when arm cameras are missing or not detected.

How do I reseat kiosk hood camera cables?

Step-by-step guide for reseating the hood camera USB cables inside the kiosk body when hood cameras are missing or not detected.

Why is the rear CSR scanner not scanning?

Troubleshooting steps when the rear CSR scanner stops scanning: reseat the USB cable and power cycle the kiosk.

How do I resolve a scale sticking?

Steps to fix a kiosk scale that won't reset to zero after items are removed, including checking the Hold function, physical interference, the shipping screw, and scale leveling.

Why is the scale not turning on?

Troubleshooting steps for when the kiosk scale will not power on.

How to Verify CSR Display Cabling

Video guide for verifying that the CSR display cable connection on the kiosk is secure.

How to Verify Light Pole Cabling

Video guide for verifying that the LED light pole cable connection on the kiosk is secure.

How to Verify Printer Cabling

Video guide for verifying that the USB and power cable connections between the kiosk and thermal printer are secure.

Why is the Sound Not Working

Fix kiosk sound that's missing or too quiet: check the volume in Staff Mode, power cycle and reseat the speaker cables.

Why is the side UX display flickering or only showing half the screen?

Resolve a flickering or half-screen Side UX display by reseating the HDMI cables on the kiosk and inside the Side UX housing, then power cycling.

Why is the side UX display blank?

Restore a blank Side UX screen by checking power indicators, reseating the HDMI and Display Power cables inside the Side UX, and power cycling the kiosk.

Why is the side UX display not responding to touch?

Restore touch input on the Side UX by safely powering down both the kiosk and Side UX, reseating the Display Touch USB cable inside the Side UX, and powering everything back on.

How do I resolve an unresponsive staff checkout screen?

Fix a staff screen that won't respond to touch: power off from Staff Mode, reseat the HDMI and USB cables, and power back on.

Why isn't the kiosk reacting to a placed item?

What to do when the kiosk doesn't react to an item on the base: Sync, Refresh, then a power cycle.

Why is the kiosk printer not printing?

Fix a kiosk printer that won't print: check power, run a test print from Staff Mode, reseat the cables and power cycle.

How do I delete a bad pose?

How to delete a bad pose from an item in Staff Mode, and when to contact Support instead.

Why is the front barcode scanner not working?

Fix a side barcode or QR scanner that stops scanning: test it in Staff Mode, check power, reseat the USB cable and power cycle.

What if an item doesn't scan right?

Covers why items fail to scan correctly on the Mashgin kiosk — including "What's this?" prompts and misrecognition.

Troubleshooting Function Key QR Codes

Guide containing scannable codes that serve as keyboard keystrokes when a keyboard is required.

What can I do if the kiosk is not turning on?

Troubleshooting steps for a kiosk that won't power on — check indicator lights, reseat power cables, test the outlet, swap cables, and power cycle.