Printer issues

The printer is the most physically delicate part of a BoothIQ kiosk. This article covers the common printer problems and what to do about each.

Symptom: Printer pill is red, customer paid but no print appeared, prints are jamming, or prints have weird colors / streaks / borders.

Quick check first

  1. Open admin → Diagnostics tab.
  2. Look at the Printer status card.
  3. Read the status pill and the message underneath.
  • Out of paper. Paper roll is empty
  • Out of ribbon. Ribbon is exhausted
  • Jam. Paper or ribbon is misfeeding
  • Door open. The printer service door isn't fully closed
  • Cooling. The thermal head is too hot. It'll resume on its own
  • Offline. Printer isn't responding (USB or power issue)
  • Communication error. The DNP SDK can't reach the printer

Step 1: Look at the actual printer

Walk around to the printer (usually behind or below the touchscreen on the kiosk):

  1. Is the power LED on the printer lit?
  2. Is the service door fully closed?
  3. Is there a physical jam visible? Paper sticking out partway, ribbon torn?
  4. Are the media indicators showing low / empty?
  5. Does the printer have any flashing error LEDs?

Most printer problems are visible from the printer itself, not from the screen.

Step 2: Out of paper or ribbon

If the printer reports out of paper / ribbon:

  1. Open the printer's service door.
  2. Remove the empty paper / ribbon assembly.
  3. Install a fresh DNP roll. Make sure both the paper roll and the ribbon are seated correctly and not crossed.
  4. Close the service door firmly.
  5. Wait for the printer's status LED to settle (10-30 seconds).
  6. Check the Printer pill in admin. It should turn green.
  7. Run a Test Print from the Diagnostics tab to confirm.

For full instructions on changing the roll, see Changing the print roll.

Step 3: Paper jam

If you see paper or ribbon stuck:

  1. Power off the printer (use the printer's own power switch, not the kiosk's).
  2. Open the service door.
  3. Carefully remove the jammed paper. Don't yank. The thermal head is fragile.
  4. Inspect the paper roll for tearing. If it's torn, you may need to cut a clean edge before reinserting.
  5. Inspect the ribbon for tears or wrinkles. If wrinkled badly, you may need a new ribbon.
  6. Reseat both rolls.
  7. Close the service door firmly.
  8. Power on the printer.
  9. Wait for the status LED to settle.
  10. Run a Test Print.

If you can't clear the jam yourself, contact support.

Step 4: Printer is offline (no error message, just dead)

The printer card says "Offline" or "Communication error" but you don't see a physical problem:

  1. Power-cycle the printer. Turn off its power switch, wait 10 seconds, turn it back on. Wait for its LEDs to settle.
  2. Check the Printer pill in admin. If green, you're done.
  3. If still offline, power-cycle the kiosk as well. (Sometimes the DNP SDK gets stuck and needs the host to restart.)
  4. If still offline after both power cycles, the printer's USB connection may be loose. This is internal. Contact support.

Step 5: Print quality problems

White borders on prints

Prints come out with a white margin instead of edge-to-edge.

The borderless setting in the printer's print queue may have been overridden. This shouldn't happen on a locked-down kiosk, but if it does, contact support. Borderless mode lives at the OS level, not in BoothIQ admin.

Streaks across prints

Horizontal or vertical streaks usually mean:

  • Dirty thermal head. See Cleaning the printer
  • Damaged ribbon. Replace the ribbon
  • Damaged thermal head. Contact support

Wrong colors

Prints come out with strange tints, missing colors, or oversaturated:

  • Ribbon misaligned. Open the printer, reseat the ribbon, run a test print
  • Defective media. Try a different roll. If a new roll fixes it, the old roll was bad
  • Color profile / driver issue. Contact support

Faded or washed out prints

  • Old or stored-in-heat media. Try a fresh roll
  • Thermal head wearing out. Contact support; thermal heads have a finite lifespan

Smudged prints

The customer touched the print before it cured. Tell customers not to handle prints immediately after they come out. Wait a few seconds.

Step 6: Printer ran out of paper mid-customer-session

A customer paid, the print started, and the printer ran out of paper before all copies were done.

  1. The booth's print retry logic will try a few times before giving up.
  2. Open the printer service door and change the paper roll immediately.
  3. Wait for the Printer pill to go green.
  4. The pending print job should resume automatically, or you may need to run a Test Print to flush the queue.
  5. Comp the customer. Add credits equal to one session in the Credits tab. And let them retry.

Step 7: Test Print fails repeatedly

You've tried all the steps and Test Print still fails:

  1. The printer hardware is genuinely broken.
  2. Take the booth out of service (Free Play mode + a sign on the front saying "Out of Order").
  3. Contact support with:
    • The Booth ID
    • The error message from the Printer card in Diagnostics
    • What you've already tried
    • When the problem started

Common patterns

Printer fails after a long event.

Thermal head overheated or media exhausted. Wait for cooling, change media.

Printer pill red after a power blip.

DNP SDK lost the printer. Power-cycle the printer.

Quality drops mid-roll.

Defective paper or ribbon. Replace media.

Random jams.

Incorrectly seated rolls. Re-seat carefully.

Printer never recovers from a jam.

Internal damage from forcible jam removal. Contact support.

When to call support

Contact support if:

  • The same error happens after multiple power cycles
  • You can't physically clear a jam
  • The thermal head looks damaged
  • Test Print fails after fresh media
  • The printer is producing unusable prints from a fresh roll

Verify it worked

The printer is recovered when:

  • The Printer pill is green
  • A Test Print produces a clean, sharp, borderless print
  • A full customer session prints successfully
  • The Prints Remaining indicator is updating correctly

Next steps