Articles in this section

Troubleshooting: Label Printing Issues

Formatting errors when printing carrier labels (UPS, FedEx, USPS) can result in unscanned barcodes, cut-off addresses, lost packages, or carrier surcharges. Use this guide to configure your label settings correctly in ShipHero.

Pro Tip

Always check your print preview before printing a large batch to confirm the address and barcode are not touching the label edges.

Label Printing Troubleshooting Checklist

  1. Set Scale to Actual Size (100%): The Fit to Page setting shrinks a standard 4x6 label, making the barcode too small for carrier scanners to read. Set your printer scale to 100%.
  2. Match Paper Size to Label Size: Most shipping labels are 4x6 inches; some carriers like Australia Post use A4. If your printer is set to Letter (8.5x11), the label may print in a corner or appear stretched. Verify the paper size matches your label media.
  3. Verify Orientation: If the label prints sideways or across two stickers, toggle between Portrait and Landscape in the print preview to match how labels feed into your printer.
  4. Check Darkness and Dithering Settings: A fuzzy or gray barcode won't scan reliably. In your printer properties, increase Darkness or Density, and set Dithering to None or Ordered for crisp lines.
  5. Clean the Print Head: White streaks through a barcode on a thermal printer usually mean dust on the heating element. Wipe the print head gently with an alcohol swab.

Quick Fix Table for Labels

If the label is...Do this:
Too small or tinyChange Scale to Actual Size or 100%.
Cut off at the edgesCheck that Paper Size matches the label size returned by the carrier.
Faded or greyIncrease Print Density or Darkness in settings.
Stretched outUncheck Fit to Page or Fill Paper.
Was this article helpful?
0 out of 2 found this helpful

More Resources

  • ShipHero Public API

    Connect your tools and AI agents directly to ShipHero with the Public API. Build powerful integrations, automate workflows, and tap into real-time data using the AI tools you prefer, with the option for secure, read-only access for AI-driven insights without added risk.

  • ShipHero Academy

    Explore ShipHero Academy for certifications, deep-dive training, and expert-led courses on WMS and fulfillment. Build your expertise and help your team operate at a higher level.

  • Change Log

    Stay up to date with the latest improvements across ShipHero. The Change Log gives you a clear view of new features, enhancements, and fixes as they roll out—so you always know what’s new and what’s better.