Quick diagnosis: When a shipping label fails to print from ShipStation, first identify the output method. Downloading a label as a PDF and printing it through a browser or desktop viewer is a different workflow from using ShipStation Connect or another integrated printing route. If one route works and the other fails, you have a much narrower problem than “the printer is broken.”
ShipStation’s interface, supported integrations and printing options may change over time. If you are instead printing labels through Shippo, use our Shippo 4×6 PDF and printer setup guide; the services have different application print paths. Rather than rely on a possibly outdated menu path, this checklist uses tests that work across common browser, PDF and desktop printing arrangements. Record the account workflow, browser, computer operating system, printer model, connected application and the label format being generated.
Identify which stage fails
| What happens | Test | Interpretation |
|---|---|---|
| No label preview or download appears | Check that the label was generated and browser prompts | Application/export stage |
| PDF opens correctly but physical label is blank | Print a known-good sample from same viewer | Rendering, driver, or thermal media |
| Integrated print shows a missing device | Inspect local printing helper and selected printer | Device discovery or integration |
| Job is pending in Windows | Watch destination queue | Spooler, port or offline state |
| Physical output is small or clipped | Compare source PDF dimensions and stock size | Page-size or scaling mismatch |
Nine troubleshooting steps
1. Determine whether a label was actually created
A carrier label that has not finished generating cannot be printed successfully from any device. In the authorized ShipStation workflow, check the shipment state and whether the label is available to view or download. If the application shows an error, note its wording exactly. Do not create repeated shipments or purchase duplicate postage merely to test a printer.
Protect customer addresses and tracking numbers when taking screenshots for troubleshooting. A cropped interface message is often sufficient to identify an export problem.
2. Test the downloaded PDF independently
Where your permissions allow it, download the generated label and open it in a trusted local PDF viewer. Verify that the address and barcode are present, that the page count is correct, and that the page measurements match the media you intend to use. If the PDF is visibly empty before printing, the printer is not responsible for creating the missing content.
Print a harmless sample page before sending a genuine shipment. Avoid uploading customer labels to untrusted online converters.
3. Confirm the printing path you are using
A browser print dialog, an operating-system print queue and a vendor-specific integrated printing service are distinct layers. For a broader explanation of these distinct software functions, see our thermal printer software workflow guide. Check which path the ShipStation action triggers on your workstation. When the browser simply downloads a file, you must choose a local viewer and device; when an integrated route is configured, confirm the relevant local service is running and the intended printer is available there.
Do not assume a printer chosen in Windows is automatically the one selected by ShipStation’s integration.
4. Check the default and explicitly selected printers
Look for stale printer names, another printer of the same model, or a queue created before the device was moved. Select the intended printer explicitly during one controlled test. Note whether the job enters the correct queue. On shared shipping stations, keep a record of separate thermal and office-paper printers because they may use different stock sizes.
Changing the system default may not affect a previously saved selection inside an application or printing helper.
5. Inspect ShipStation Connect or equivalent integrated printing setup
If your installation uses ShipStation Connect, consult ShipStation’s current official support instructions for your operating system. Verify that the app or service is signed in and available where required, that the printer is mapped correctly, and that the local OS can print to it. The exact options and their labels can vary between versions.
A working PDF print but failing integrated print is evidence to check the integration or its mapping first, not a reason to clean the printhead.
6. Compare 4×6 label output with the printer’s stock
A 4×6 thermal label is 101.6 × 152.4 mm. Check the size of the generated page, the printer driver’s selected stock and the scale in the print dialog. Use actual size where the shipping workflow requires it, and disable unrelated browser headers and footers. A Letter-sized label PDF may need a supported carrier or platform setting rather than a guess at manual cropping.
Do not cut away the barcode’s quiet zone or stretch a carrier symbol simply to make the layout appear centered.
7. Test one job and observe its queue state
Send a single approved print and monitor the relevant Windows or macOS queue. A job that never arrives suggests an application or integration stage problem. A job that remains paused suggests a queue or connectivity problem. A job that completes and feeds blank stock suggests a source-document, driver-rendering, or media issue.
If others use the printer, avoid clearing all pending orders or resetting their print service without coordination.
8. Compare browsers and PDF viewers methodically
Print the same authorized file with one second trusted viewer, if permitted. If it works outside the original browser, record the browser version and its print settings. Pop-up blockers, download preferences and saved browser page-scale options can change what actually gets printed.
Preserve the original source label file as the control; editing the file while changing applications creates two variables at once.
9. Investigate changes that preceded the failure
Did the problem begin after a printer replacement, driver upgrade, operating-system update, browser change or a new shipping-station login? Document the timeline. On managed systems, ask the administrator before replacing the integration app or restarting services used by other shipping users. Use vendor-supported downloads and verify requirements for the current ShipStation release.
After each authorized change, retest the same one-page sample and compare both the screen output and physical result.
What a reliable support report includes
State which path fails—download, browser PDF print, or integrated print. Include the printer model, operating system, browser and local printing-helper versions if relevant, whether the PDF preview is correct, source page size, queue behavior and exact error text. Mask personally identifiable information. A support team can then focus on the correct stage rather than asking you to reinstall every component.
For current features and supported integration steps, use the official ShipStation website and its linked help resources. This article does not claim that a particular menu or local service behaves identically in all versions.
Frequently asked questions
Why can I download a label but not print it from ShipStation?
The label-generation stage may be successful while the integrated printing service, selected printer or print queue is not. Compare a direct PDF print with an integrated print to isolate the responsible step.
Why is my ShipStation label printing too small?
Check the source page dimensions and the printer stock first. A 4×6 label sent through Letter-size or Fit settings can shrink or clip the content even when the printer is functioning.
Should I keep clicking “Create Label” until it prints?
No. Repeated creation may generate extra postage or duplicate transactions. Verify that the existing authorized label can be previewed or printed before changing the shipment.
Is a blank physical label always a ShipStation bug?
No. A printer can feed incompatible media, a driver can render a blank page or a source document can be missing content. A printer-independent diagnostic and a known-good PDF distinguish these situations.
Related LabelFix Lab guides
- Shipping label prints blank from Chrome
- Windows print job stuck in queue
- 4×6 label prints too small
- Multiple labels on one PDF page
- Check a label PDF’s page size
Editorial note: This guide distinguishes printing layers but does not substitute for ShipStation’s current version-specific support articles. No live order or carrier label was tested.
Independent general troubleshooting information for shipping labels and thermal printers. Model-specific button sequences, cleaning supplies and service instructions can differ; consult your manufacturer's official documentation. Never alter a carrier-generated barcode.
