Troubleshooting
Troubleshooting
Symptom-indexed guide for common NotBot issues.
Last updated 2026-05-23 · Applies to NotBot 1.3.4+
Most NotBot problems fall into a handful of patterns. Find your symptom below. The first sections (Buyer Only repeat-buyer behavior, auto-print resets, missed Whatnot events, the Mac "Too many active jobs" error, the Whatnot mobile layout issue) come from real support investigations. The thermal-printer calibration and sleep-mode sections are generic starting points. Your printer's manufacturer documentation is the source of truth for those.
My printer isn't showing up in NotBot
- Click Refresh in Settings → Print Settings to rescan.
- Make sure the printer is installed and visible in your operating system's normal print dialog. NotBot reads from the same list. If you can't print to it from TextEdit (Mac) or Notepad (Windows), NotBot won't see it either.
- Install the manufacturer's driver. The generic operating-system drivers ("Generic / Text Only", "Generic Text Printer") do not work with NotBot on either Mac or Windows. Download the driver from the printer manufacturer's website.
- USB is the most reliable connection. Wi-Fi and Bluetooth thermal printers work, but they are more prone to flaky behavior during long shows. If you have a choice, use USB.
A Windows test page prints, but NotBot can't print
A Windows test page using a generic driver does not validate that NotBot will work. NotBot needs the manufacturer's actual driver installed. If you used Windows' generic driver to get a test page out, install the proper driver and try the Test Print in Settings again.
Labels print at the wrong size or get chopped off
- Check Settings → Printer Configuration → Media / Roll. Switch from Auto-detect to the exact label roll loaded in your printer. This is the single most common fix for misaligned prints.
- Check Feed Direction. Landscape (Rollo, Munbyn-style) versus portrait (DYMO, Brother-style) matters. If everything is rotated, this is the toggle.
- On Mac with 4x6 labels, the default Feed Direction is portrait, not landscape. This is intentional and matches how 4x6 shipping rolls feed on Mac. Other sizes default to landscape.
Labels print rotated 90 degrees
Switch Feed Direction in Settings → Printer Configuration. If they're rotated the other way after flipping, switch back and check that the Media / Roll size matches your actual paper.
My printer feeds extra labels or skips after a paper change
Most thermal printers need a calibration routine after you swap roll sizes. The exact method varies by manufacturer. Check your printer's manual or the manufacturer's support page. As a starting point, common calibration triggers are holding the feed button for a few seconds while powered on (Rollo, Munbyn) or pressing the power button rapidly (Jadens-style). If your printer feeds extra blanks or misregisters, run the calibration the manufacturer prescribes.
My printer prints a few labels, then waits, then prints them all in a batch
Some thermal printers enter a deep-sleep mode after a short idle period. When the next print arrives, the printer wakes up, then prints both the new label and any backlog that built up while it was asleep. Some printers expose this as a sleep or power-saving timeout in their settings; some don't. Disabling deep sleep or extending the timeout fixes this on printers that expose the option.
"Too many active jobs" error on Mac
If labels start failing mid-show on Mac with a "Too many active jobs" error, your Mac's print queue for that printer has hit its job cap. This happens when the printer stalls (sleep, USB drop, paper jam, out of paper) and jobs pile up behind it.
To fix:
- Open System Settings → Printers and Scanners.
- Select the printer and open its print queue.
- Delete every job in the queue.
- Resume or restart the printer if it's on hold.
Then resume the show. If a show is in progress and you can pause new bids while you do this, do. Otherwise NotBot's automatic retries will pile back on top of the cleared queue.
I see "Auto-print disabled" mid-show
Auto-print resets when NotBot detects a stream change. A brief connection drop can cause this reset and silently turn off auto-print. Wins that fired before the reset are unaffected. To resume, click the Auto-print toggle in the Live Activity panel.
A stable internet connection (wired ethernet if possible, otherwise a strong Wi-Fi signal) reduces how often these drops happen.
I see the orange "connection lost" banner
The banner appears when NotBot's connection to Whatnot's live feed drops. The cause can be either Whatnot's servers or your computer's internet. The banner's wording reflects both possibilities.
- If only Whatnot is broken and the rest of your internet works fine, Whatnot itself is having an issue. Wait for them to reconnect.
- If multiple things on your computer are also broken, your internet is the problem. Switch to wired ethernet if you're on Wi-Fi, or restart your router.
Auctions are missing from a Whatnot show
If you see a gap in your auction numbers on a Whatnot show (#3 followed by #5, with no #4), the missed win almost certainly happened during a brief connection drop. Whatnot does not re-send dropped events when the connection comes back, so NotBot has no way to retroactively pick them up.
Recovery options:
- Look up the winner in your Whatnot seller dashboard.
- Use the + Add missing auction button at the top of the auction history in NotBot. Enter the item name, winner, and price. NotBot will assign a buyer number and print the label as if the win had been received normally.
For future shows, a stable wired internet connection significantly reduces the rate of dropped events. The same general principle applies on Poshmark Live and eBay Live, but their support is in beta and the exact recovery flows are evolving.
The Whatnot Auction and Giveaway seller tabs are missing
If you log into Whatnot inside NotBot and the Auction and Giveaway seller controls aren't visible, the browser has switched to a mobile layout because the panel is too narrow.
- Make the NotBot window wider. Full screen is ideal.
- Drag the divider between the browser and the dashboard further to the left to give the browser more space.
- If the tabs still don't appear, check your operating system's display scaling. Scaling of 150% or higher can force the mobile layout even when the window looks large enough. Lower the scale setting and refresh the Whatnot page.
A platform login is stuck or won't sign me out
Settings → Advanced has a Clear browser cache and restart button. This wipes the built-in browser's cookies and storage and relaunches NotBot. You'll need to sign back in to your platform afterwards. Your NotBot account, settings, and show history are unaffected.
Print Queue shows lots of "Stuck" labels
A label goes to Stuck when your operating system held it in the print queue for more than two minutes without finishing. The usual causes:
- Printer is offline, out of paper, or jammed.
- Printer was unplugged or its USB cable was bumped during the show.
- Printer's network connection (Wi-Fi or Bluetooth) dropped.
Fix the physical printer issue, then tap to retry the stuck labels from the Recent Labels panel.
I have multiple printers and prints are inconsistent
If you have several printers configured and prints sometimes go to one, sometimes to another, sometimes fail, that's per-event printer routing in action. Either:
- Pick one printer as your main and stabilize on it (the simplest path), or
- Configure per-event routing intentionally so each event type goes to the right printer. See Settings Reference.
NotBot won't print a label for a returning buyer's auction win in Buyer Only mode
That's intentional. Buyer Only mode prints one buyer label the first time a buyer wins an auction, then nothing on later auction wins by the same buyer (they reuse the box that already has their label on it). If you want a label per auction, switch to Every Item or Every Item + Buyer. See Print Modes.
If you want extra reprint labels for heavy spenders every N events, turn on Reprint at purchase milestones in Settings → Advanced.
Buy It Now and giveaway events in Buyer Only mode follow the Purchase labels and Giveaway labels settings. The default for both is Item label, so returning buyers still get an item label for those events. See When NotBot Prints for the full decision table.
NotBot isn't printing buyer/box labels for giveaway winners or Buy It Now buyers in Buyer Only mode
That's expected. In Buyer Only mode, giveaways and Buy It Now sales default to Item label. NotBot prints an item label and does not print a separate buyer/box label. To change this, go to Settings → Advanced → Buyer Mode Labels and set Giveaway labels or Purchase labels to Buyer label only or Buyer + item labels. See Print Modes.
My computer went to sleep mid-show
If your computer sleeps, NotBot loses its connection to the live feed and any wins that fire while you're asleep are missed. This applies on Mac and Windows, on battery or plugged in.
- Mac: System Settings → Lock Screen → set "Turn display off when inactive" to Never. System Settings → Battery → Options → enable "Prevent automatic sleeping when the display is off". Plug in if you're on a laptop.
- Windows: Settings → System → Power & battery → Screen and sleep → set both Screen and Sleep to Never while plugged in, and the same for On battery power if you're on a laptop.
I want to test my labels without doing a real show
Use Settings → Print Settings → Print Test Label. This sends sample labels to your printer through the same real print path you'll use during the show. It's the right way to verify your printer setup before going live.
Preview Mode opens labels as PDF files in your system viewer instead of printing them. That's useful when designing templates but doesn't validate your printer setup. Don't use Preview Mode as a substitute for a real Test Print.
Something else
Email support at support@mellowtools.com. If you can include rough timestamps for when the issue occurred and your NotBot version (Settings → About), we can usually pull the relevant diagnostic logs and identify the cause quickly.
See also
- Settings Reference for every setting and what it changes.
- Print Queue for what each queue status means.
- Privacy for what's in the diagnostic logs we look at when you email support.