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 access kiosk manage mode?

Learn the three ways to access Manage Mode on the Mashgin kiosk: tapping the logo, swiping, or scanning 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 Checkout?

Overview of the Staff Checkout app — what it does, the Quick Actions menu, and how to look up past transactions from the side screen.

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 feature on your Mashgin kiosk, including display identification and rebooting to complete setup.

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 Manage Mode > Transactions, or scan a QR code for a virtual receipt if printing is disabled at your location.

Round Up for Charity

Overview and setup for the Round Up for Charity feature — what customers see at checkout, when it does and doesn't appear, and how to enable it for your locations.

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?

Step-by-step guide to connecting a kiosk to a new assigned location using the Initial Setup process via Manage Mode → Advanced → Initial Setup.

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.

🌐 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?

Steps to clear a License Expired alert by registering the kiosk to fetch a valid license from Manager Mode.

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?

Resolution steps for the Invalid License alert — caused by a location mismatch between the kiosk and its assigned license; fixed in seconds via Manager Mode > Advanced > Register 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?

Resolution steps for the Missing Network Configuration alert — verify network settings, run a Network Test, reconnect to grid, reseat the cable, power cycle, and validate the port.

How do I resolve a NiCam issue alert?

Steps to resolve the NiCam alert on a kiosk — check that the camera is detected in Manager Mode, reseat the NiCam cable, and power cycle the kiosk if needed.

What does the license expiration notification mean?

Explains the kiosk license expiration reminder, what it affects, and the steps to re-register the kiosk to refresh the license.

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?

Step-by-step troubleshooting guide for resolving a kiosk offline alert, covering network settings, reconnection, ethernet reseating, power cycling, and cable replacement.