troubleshooting guide

My Shipping Label Barcode is Not Scanning — How to Fix It

Troubleshoot a shipping label barcode that will not scan by checking scale, quiet zones, contrast, damage and printer output without claiming carrier approval.

Best next step

Follow the symptom-led steps before buying or reprinting postage.

Start with the tool or template that matches this guide before printing paid postage again.

Last reviewed: 2026-08-29

Quick answer

Treat a failed phone or handheld scan as a symptom, not a carrier verdict. First restore the original page geometry, then inspect barcode whitespace, contrast, bar damage and flat placement. Reprint from the original file if the symbol was resized, cropped, streaked, wrinkled or covered.

Symptom-led fix

Check geometry before print quality

A barcode can fail because the whole page changed, the bars printed badly, or the surrounding space and placement were damaged.

A phone scan is a diagnostic clue, not carrier acceptance or standards verification.

The label was resized or cropped

The printed boundary differs from the source, or barcode whitespace disappeared.

Fix page size and scale first. A scan test is not meaningful evidence while the whole symbol has been changed.

Verify physical scale

Bars are faint, broken or spread

The boundary is correct, but thermal streaks or ink bleed change the bars.

Run a print-quality test. For thermal printers check media, density, speed and printhead condition; for inkjet or laser printers use clean, high-contrast output.

Test print quality

The printed code looks clean

The barcode still touches an edge, fold, tape or nearby print, or only a phone app says it scans.

Check clear surrounding space and flat placement. Reprint damaged output and ask the issuer or carrier when acceptance remains uncertain.

Review surrounding space

Preflight checklist

Restore the original label geometry before scan tests.
Inspect quiet space, contrast, bar damage and placement separately.
Reprint damaged output; do not treat a phone scan as approval.

1. Restore geometry before testing scans

Compare the physical boundary and barcode with the original PDF. If Fit, a screenshot, a crop or the wrong media changed the symbol or its surrounding white space, fix page size and scale first. Repeated scanning of altered output does not validate it.

2. Check quiet space, contrast and damage

GS1 lists quiet-zone size, contrast, symbol size, bar height, packaging interference, deterioration and position among common quality checks. Use those as diagnostic categories, not universal numeric limits for a carrier-specific symbol.

3. Split thermal and sheet print quality

For direct-thermal output, test media, printhead condition, density and speed using the model's manual; Zebra documents that heat, speed and media work together. For inkjet or laser output, use clean black output on suitable white stock and reject bleed, dropout or low contrast.

4. Stop on an obstructed or uncertain code

Keep the barcode flat and away from folds, seams and glossy tape. Reprint if bars are broken, quiet space is missing or the label is damaged. A phone-camera success is only a quick check; ask the issuing platform or carrier when handoff remains uncertain.

Source notes

General troubleshooting framework: GS1 identifies common barcode-quality factors, Zebra documents one thermal print-quality path, and carrier sources cover placement. This page is not barcode verification or a guarantee of carrier acceptance.

This page is a practical print-setting checklist, not official carrier policy or a promise that a label will be accepted.

Confirm the current format in your platform or carrier account, keep the original PDF, and stop if a test print is cropped, blurred or incorrectly scaled.

Troubleshooting advice is general. Record the printer model, paper size, PDF viewer and scale setting so you can verify each change.

GS1 barcode quality checks · GS1 lists quiet zones, contrast, symbol size, bar height, damage, packaging interference and position as quality factors. · Link checked 2026-08-29
Zebra adjusting thermal print quality · Zebra documents the interaction of heat or density, print speed and loaded media for representative thermal printers. · Link checked 2026-08-29
FedEx shipping-label placement · FedEx advises keeping barcodes flat, away from seams and edges, and free of clear tape. · Link checked 2026-08-29

FAQ

Does a phone scan prove that a shipping label is acceptable?

No. It is a diagnostic clue, not standards verification or carrier approval.

What should I check before changing printer darkness?

Confirm the page boundary and barcode were not resized or cropped. Geometry errors come before density tuning.

What should thermal-printer users test?

Use the exact model's procedure to test media, printhead condition, density and speed after page size and calibration are correct.

What should inkjet or laser users test?

Look for black-to-white contrast, clean bar edges, ink bleed, dropout and damage, then keep tape and folds off the code.

When is a reprint safer than another scan test?

Reprint when the symbol is resized, cropped, streaked, blurred, wrinkled, wet or covered, or when required surrounding space is missing.