Printing Problems: Symptom, Cause, Solution

Published · Updated
HOW TOTroubleshooting · Printing

Printing mostly works in Windows and is managed in two places: the left menu 'Run → Print' settings page (add printer, tweak, behavior, limits) and the Print button on the post-capture booth results screen. This document explains typical symptoms such as no printout, wrong size, offline printer, 2 inch cutout, and button not appearing at all, with causes/solutions verified from real code.


i
before you start
  1. event-creation
  2. print-settings

step by step

Symptom: 'Print' button does not appear at all in Booth results screen

Print, Printing Behavior

Reason: The print button in Booth only appears if three conditions are met simultaneously (code: SharingPageBlazorViewModel.IsPrintVisible), (1) result rendering is complete (printable), (2) 'Enable Print Button' (PrinterEnabled) is on, (3) event printing limit is not reached. The most common reason is the second item: this setting is derived once when CREATING the event and defaults to OFF in pure video type events (Video360 / Glambot); Comes ON for events with printable output (photo/GIF/boomerang). Solution: In the left menu 'Run → Print' → Printing Behavior section, turn ON the Enable Print Button switch. When the switch is on, guests are presented with a manual Print button on the results screen.

🔎 Elements on the screen: Printing Behavior title; Enable Print Button on/off switch; status text On/Off; description 'Show a "Print" button on the results screen for manual printing.'

Printing Behavior section: Enable Print Button key in On location, description text below.
Printing Behavior section: Enable Print Button key in On location, description text below.

Symptom: 'Print' button does not open even in the event that takes photos/GIFs

Print, Printing Behavior

Cause: Enable Print Button is no longer reactive (decided 2026-06-29), it is only set once when creating the event, it will not be opened automatically if you change the shooting mode afterwards (e.g. add a photo to the video event). So, if pure video was initially selected and then photos were added, the switch still remains off. Solution: Turn ON the switch manually. If you want to turn it off (the default is on in photo+video combined activity), you can turn it off here again, the decision is up to the operator.

🔎 Items on the screen: Enable Print Button key; On/Off status text.

Symptom: Print button shows 'Limit Exceeded' or button does not appear at all

Print, Printing Limits

Cause: Print limit exceeded. The code implements two different behaviors: When the ACTIVITY limit is reached, the button is completely HIDDEN (IsPrintVisible=false), and when the SESSION (admin) limit is reached, the button remains but is deactivated with the text Limit Exceeded (LimitExceeded). Limit fields are considered 'unlimited' if left less than 1 or blank (code: value < 1 → int.MaxValue). Solution: In the 'Printing Limits' section, increase the 'Event Printing Limit' and 'Prints Per Session' values; If you want completely unlimited, leave 0 (or blank). If Print Window Maximum is less than 1, the default is 5.

🔎 Items on the screen: Print Limits section; Event Print Limit, Prints Per Session, Print Window Maximum number boxes; 'Limit Exceeded' sticker on the booth.

Print Limits section: three number entry boxes (Event / Per Session / Window Maximum) appear.
Print Limits section: three number entry boxes (Event / Per Session / Window Maximum) appear.

Symptom: Printing starts but no output comes (no printer added)

Print, Add Printer

Cause: If no printer is added to the event, the print job fails immediately, the code 'NoPrinterSelected' / 'No printer selected.' If the code marks Failed (GeneratePrintJob), automatic printing also does not print silently. Solution: Click the purple Add Printer button in the Add Printer section, click on the printer from Local Printers or Remote Printers in the window that opens and change it to Added. If the list is empty, No printers found appears, connect the printer and press Refresh.

🔎 Items on the screen: Purple Add Printer button; Local Printers/Remote Printers, Add/Added badge in modal; No printers found if empty; Refresh.

Printer addition window: a printer under the title Local Printers and the Add badge to the right of it, Cancel and…
Printer addition window: a printer under the title Local Printers and the Add badge to the right of it, Cancel and Refresh at the bottom.

Symptom: Printer appears 'Offline' / 'Printer Offline' warning on printing

Print, Add Printer

Cause: None of the printers added to the event is online. In this case, the booth button goes into error state Offline and when you try to press it, the warning Printer Offline / The selected printer is not available appears (the payment flow is never entered, money is taken and the inability to press it is prevented). If more than one printer is added and only one of them is offline, prints are routed to the working printer; a test print, however, goes to the printer whose tab is selected in the Printer Settings section, and if that printer is offline you get Test print failed. The system checks every 5 seconds; When the connection is lost/resumed, 'Printer is offline. Please check your usb cable.' or for WCM 'check the WCM connection.' notification drops. Solution: Check cable on local USB printer, network connection on WCM/wireless printer; Then press Refresh in the printer adding window. Read the colored status text in the connected printer row (Ready, Paper Out, Paper Jam, Busy, Printing, Door Open).

i
Version note

Skipping an offline printer arrived with 3.3.0. In older versions, when the first printer in the list was off, the booth blocked printing completely even if the second printer was on.

🔎 Items on the screen: Status dot + text on the connected printer line: Offline/Online/Ready/Paper Out etc.; booth warning Printer OfflineThe selected printer is not available.

A printer row in the list of connected printers with status Offline in red; next to the Remove button.
A printer row in the list of connected printers with status Offline in red; next to the Remove button.

Symptom: A print sent to a remote station did not come out

Print, Add Printer (Remote Station)

Cause: The job went to a printer connected to another computer on the same subscription (Remote Station) but could not be printed there, e.g. that printer ran out of paper, the printer is off, or the station computer is not connected to the internet. In 3.6.0 and later, an error window titled 'Print Failed' opens on the device that sent the job; it shows the error text from the station or, if there is none, 'The print job failed on the remote print station.' Solution: Go to the station computer; check its printer's status (Paper Out, Paper Jam, Offline, etc.) and that the computer is on and connected to the internet; fix the problem and send the print again.

i
Version note

In versions before 3.6.0, a print that fails on the remote station produces no warning on the sending device. In these versions, check the printout at the station yourself.

🔎 Items on the screen: Error window titled 'Print Failed' on the sending device (3.6.0 and later); Remote Station in the connected printer row.

Symptom: The actual event print comes out at the wrong size

Print, Printer Settings

Reason: The actual guest print size comes from the size of the TEMPLATE USED (OutputSize/DeclaredSize), NOT from the paper size menu in Print Settings. That menu is for preview and test printing only. If the template size is incorrect, the output will print in the wrong size. Solution: Select/edit the template in the correct output size. The 'Horizontal/Vertical Position' and 'Horizontal/Vertical Scale' sliders in the Printer Settings section are alignment/scale tweaks only (do not change the size); If the paper has white edges/bleeds, use those. For A4, A5 or A6 templates, in 3.5.4 and later Windows selects the paper by its dimensions; in older versions only the aspect ratio was checked, so the wrong paper could be selected. On Android, a DNP printer connected directly via USB currently prints only 4x6 templates (and 2x6 strips).

🔎 Items on the screen: Printer Settings section; Horizontal Position/Vertical Position (-20…+20), Horizontal Scale/Vertical Scale (80%…120%) sliders; paper size menu (test/preview only).

Symptom: White frame around the edges of Mitsubishi CP-D90D prints

Print, Add Printer → gear icon (Windows printing preferences)

Cause: This printer's Windows driver offers two forms of the same paper: borderless and bordered ('white border'). Versions before 3.5.4 could select the bordered form on Windows; the result is a white frame on all four edges and a slightly cropped image. Solution: Update the app to 3.5.4 or later, from this version on, the borderless form is preferred. Also, open the Windows printing preferences with the gear icon in the connected printer row and select the borderless 4x6 paper; the app takes this selection into account when it matches the template size.

🔎 Items on the screen: Gear icon in the connected printer row (Windows and Mac only, local printers); paper list in the Windows printing preferences window that opens.

Symptom: Test print comes out the wrong size (e.g. 6x8)

Print, Printer Settings

Cause: In the test print, the paper size is selected from the drop-down menu under Test Print. If the size cannot be resolved (menu not selected) the print falls to the DNP CUPS driver default, usually 6x8 (code: declaredSize null → '-o media=' is not added). Solution: Select the correct size (6x4 / 4x6 / 6x6 / 6x8 / 8x6 Paper) from the paper size drop-down menu next to the 'Test Print' button, then try with Test Print → Print Test Page. The Preview box at the top shows the aspect ratio of the selected size. In 3.6.0 and later, the paper you select is remembered per printer; in older versions the menu went back to '6x4 Paper' every time you opened the page, so check the menu before every test.

🔎 Items on the screen: Paper size drop-down menu (6x4/4x6/6x6/6x8/8x6 Paper); Test Print button; Print File Viewer → Print Test Page.

Test Print row: paper size drop-down menu (e.g. '6x4 Paper') on the left, with Test Print button next to it.
Test Print row: paper size drop-down menu (e.g. '6x4 Paper') on the left, with Test Print button next to it.

Symptom: Normal (single frame) photo comes out sliced in half

Print, Printer Settings

Cause: The 2 inch cut (2x6 photo strip cut) is left open in the normal photo → the printer cuts the paper right in the middle, dividing the photo in half. Cutting only works correctly on 2x6 strip layout templates (code warning: 'only use with strip-layout template; photo will be sliced ​​if left open in normal photo'). Solution: CLOSE the 2 inch cutout on normal photo templates; Use only 2x6 strip regular templates. The cut setting makes sense on DNP/Citizen thermal sublimation printers (detail in the '2 Inch Cut' document).

🔎 Items on the screen: 2 Inch Cut (Photo Strips) key; description 'Cuts the print into 2x6 photo strips. Open only in strip regular templates.'; 'Want to Print 2x6 Strips?' connection.

Symptom: 'Calibrate 2 inch Cut' says 'not supported' or won't calibrate

Print, Printer Settings

Reason: The Calibrate 2 inch Cut button appears only on Windows (on Mac the cut is automatic with CUPS, there is no concept of calibration). If there is no printer connected, 'No printer connected, it works when a printer that supports it is connected.', if the printer cannot perform hardware cutting, 'The connected printer does not support 2 inch cutting.' take out the toast; Your printer is ready for 2 inch cut. if already ready, Calibration cancelled. if the dialog is canceled. If you click OK in the driver window without turning on the cutter, nothing is saved and the warning Cut wasn't switched on in the driver dialog, so nothing was saved. Open it again and enable the cutter before pressing OK. appears (3.3.0 and later; in older versions the 'ready' message could appear in this case too, but the printer did not cut). Solution: Connect a printer that supports cutting, such as DNP/Citizen; In Windows, select the correct printer in the 'Printer Settings' tab, click 'Calibrate 2 inch Cutting', open Cutter in the driver dialog and click OK. If the calibration is successful, the toggle is activated.

🔎 Items on the screen: Calibrate 2 inch Cut button (Windows only); toast messages: The connected printer doesn't support 2 inch cut., Your printer is ready for 2 inch cut., 'No printer connected, ...', Calibration cancelled., 'Cut wasn't switched on in the driver dialog...'

Symptom: Test print said 'sent to queue' but no paper came out

Print, Print Output Previewer

Cause: The Test print sent to queue (TestPrintSentToQueue) message DOES NOT GUARANTEE that the print is released, the system waits for the result of the job for 30 seconds; If it does not return to Success/Failed within this time (especially while the remote station is uploading to the printer), it gives the information 'sent to the queue'. If the printer is offline or there is no paper, the result is Test print failed. Solution: Check the status (Paper Out, Paper Jam, Offline etc.) on the connected printer line; on the remote station printer, make sure that computer is online and connected to the internet; Fix the problem and try Print Test Page again.

🔎 Elements on the screen: Print File Viewer window; Print Test Page button; toast: Test print completed / Test print failed / Test print sent to queue.

Symptom: I tweaked (position/scale) but wrong printer fixed/none fixed

Print, Printer Settings

Reason: Fine adjustment (Horizontal/Vertical Position and Scale) values ​​are stored SEPARATELY FOR EACH PRINTER and written to the currently SELECTED printer tab. If you move the slider while in the wrong tab, the setting will be processed to another printer. Values ​​do not have a separate Save button; It is automatically saved ~0.25 sec after the drag is finished. Solution: First select the printer you want to set from the tabs in the Printer Settings section (active tab), then move the sliders; The Preview box at the top immediately reflects the change.

🔎 On-screen items: Printer selection tabs (each connected printer a tab, active one highlighted); Adjustments panel; live Preview box ('Preview, 6x4').

Symptom: Automatic printing is on but not printing / wrong number of copies

Print, Printing Behavior

Cause: Even if Enable Auto Print is on, if no printer is added, the end-of-session print will drop without a printer and not print (the code now prevents the crash without a printer, but produces no output). The number of copies is determined by the Auto Print Count slider from 1 to 5; This slider is not visible when the switch is off. Solution: First add at least one printer (must be online), then turn on Enable Auto Print and set Auto Print Count in the Printing Behavior section. Automatic printing prints as soon as the session ends, with no touch required.

🔎 Items on the screen: Enable Auto Print key; Auto Print Count slider visible when on (1…5); description 'Automatically print photo immediately after session ends...'

i
tips

Three conditions must be met for the print button to appear in Booth: the resulting render must be complete, Enable Print Button must be on, and the event print limit must not be reached. If there is no button, check these three in order first.

Enable Print Button is derived once from the shot type when creating the event (pure video → off, photo/GIF/boomerang → on) and does not change automatically afterwards; You can always turn it on/off manually.

The actual guest print size comes from the TEMPLATE; The paper size menu in Print Settings is for preview and test printing only.

In print limit fields, a value less than 1 or empty means 'unlimited'; To set an actual limit, enter a positive number.

Calibrate 2 inch Cut and the OS printer settings gear icon appear only on Windows (and Mac) native printers; It is not available on remote stations and mobile devices.

Test print sent to queue does not mean that the output has arrived for sure, especially on a remote station printer, confirm the result from the printer status (Ready/Paper Out).

!
Common mistakes

Create a pure video (Video360/Glambot) event and expect printing: Enable Print Button is off by default in these events, turn it on manually if you want printing.

Leaving the 2 inch cut open on a normal (single frame) photo: the photo is sliced ​​in the middle. Use the cut only on 2x6 strip templates.

Printing without selecting the paper size menu in the test print: if the size is not specified, the DNP driver defaults to (usually 6x8) and the test prints the wrong size.

Being on the wrong printer tab when tweaking: values ​​are written to the printer of the selected tab; choose the correct tab first.

Waiting for printing/automatic printing without adding any printer: if there is no printer selected, the job will fail with 'No printer selected' and no output will come.

Leaving the print limit as 0 or empty and thinking that 'I set a limit': A value less than 1 means unlimited.

Trying to print repeatedly while the printer is offline: It is necessary to fix the USB cable / WCM network connection and press Refresh in the add printer window.

Related topics

Print Settings 2 Inch Cut Creating an Event Sharing Settings

Was this article helpful?

Not sure where to start? We can help.

Tell us about your project. Our team will help with the next step.

By submitting, you agree to our Terms and Privacy Policy.