Retail POS receipt troubleshooting expert

Joe B.

Reviewed for technical accuracy

Specialities: POS systems, Thermal printers (Star/Epson/Zebra), Receipt templates, Barcodes (UPC, Code128, GS1)

Gift receipt barcode missing — POS gift receipt template, barcode suppression, lookup code not printing

Technician avatar Technician
Hey! Let’s get the gift receipt barcode and lookup code back. I’ll check your POS receipt template, barcode format (UPC-A, Code 128, EAN), and thermal printer configuration (Star Micronics, Epson TM-T88, Zebra).
A few scoping questions: Which POS (Square/Toast/Lightspeed/Clover/custom)? Is the issue only on gift receipts or all receipts? Do regular receipts show a scannable barcode but the gift version does not?
Customer
We’re on Lightspeed Retail with Star TSP100 printers. Normal receipts have a UPC/Code128, but gift receipts print without barcode and there’s no lookup code either. Returns desk can’t scan them.
Technician avatar Technician
Got it. Common causes when a gift receipt lacks barcode/ILC:
• The gift receipt template hides SKU/ILC for privacy (“mask prices” often also suppress barcode).
• The POS is outputting text, not a barcode command (ESC/POS), or the field is blank for gift receipts.
• Character limits or wrong symbology (UPC sent to Code128 tag) so the printer skips rendering.
• Thermal printer settings — darkness/scale/BWR cause a faint or unreadable code that scanners treat as “no code”.
Plan: review template fields & permissions → verify barcode element on the gift layout → confirm ESC/POS commands → adjust density/BWR and print width → test with GS1-compliant sizes.
Customer
Where do I change the gift receipt template? I only saw a toggle for “hide prices”.
Technician avatar Technician
Step 1 — Enable barcode & lookup field on the gift layout
1) Lightspeed Admin → Receipts → Templates. Duplicate your main receipt as Gift Receipt.
2) Ensure the Barcode element is present and bound to a valid value: {{return_barcode}}, {{order.lookup_code}}, or {{transaction_id}} (naming varies by POS).
3) Keep Hide prices ON, but leave Show barcode / item lookup code enabled. Some systems call this “Return code” or “Reference code”.
4) For barcode symbology pick Code128 (most reliable for alphanumeric lookups). Avoid QR unless your returns stations use camera scanners.
Customer
The template had the barcode element disabled on gift receipts. I re-enabled it, but the printer still doesn’t show a bar—just white space.
Technician avatar Technician
Step 2 — Validate barcode data & printer commands
• Print a diagnostic receipt with “show raw data” if available. We’re checking that the POS sends either an image or ESC/POS barcode command to the Star TSP100.
• Make sure the field contains a value: use {{receipt.lookup_code | default: transaction_id}} as a fallback.
• If your POS renders the barcode as an image, disable “Fit to page” scaling in the Windows/Mac print dialog so the raster isn’t clipped.
• Symbology tip: for 12-digit UPC, send UPC-A; for variable length return tokens use Code128. Mismatched symbology often yields a blank area.
Customer
The code renders now, but our scanners fail half the time. The lines look light on thin paper.
Technician avatar Technician
Step 3 — Tune thermal print quality for scannability
• In Star Configuration Utility set Print Density/Darkness up 1–2 notches and enable “Black Mark Optimization” if present.
• Keep Bar Width Reduction (BWR) small (0–2) to avoid overly thin bars.
• Set barcode height ≥ 25 mm and module width 0.33–0.4 mm (GS1 guidance) for 203 DPI printers.
• Store rolls in a cool, dry place; poor thermal paper causes low contrast barcodes. Use quality 55–60 gsm paper.
• Test with multiple scanners and disable “inverse/negative” codes unless you actually print white bars on black.
Customer
We also want the lookup code printed as text under the bars for manual entry. Is that possible on the gift receipt?
Technician avatar Technician
Absolutely.
Step 4 — Add human-readable lookup code
• In the template, place {{lookup_code}} (or {{return_reference}}) below the barcode and label it “Return code”.
• Keep the gift receipt policy text (prices hidden, item exchange only) and a QR to your returns page if you want self-service scanning.
• For Zebra or Epson environments, the driver can auto-print human-readable digits for UPC/EAN; enable “HRI” (human readable interpretation) in the printer settings.
Customer
Multi-store question: some locations use Epson TM-T88VI and others use Zebra ZD410. Will this template work across brands?
Technician avatar Technician
Yes, with two tips:
• Use the POS’s rendered image barcode (raster) if your sites mix ESC/POS and ZPL/EPL. It avoids brand-specific commands.
• Keep paper width at 72–72.1 mm content for 80 mm printers and test a 58 mm variant. Set margins so the barcode isn’t clipped on narrower mechanisms.
• If you must print native: Star/Epson = ESC/POS barcode command; Zebra = ZPL ^BC/^B3. We can detect the printer and switch automatically.
Customer
After these changes the barcode scans at the returns counter and the lookup code shows beneath it. Anything else to prevent future issues?
Technician avatar Technician
Final checks:
• Lock the gift receipt template so “hide barcode” can’t be toggled by mistake.
• Standardize lookup code format (length & character set) and keep Code128 as default.
• Save a test receipt PDF per location and verify darkness/BWR on each printer model.
• Train staff: if a barcode won’t scan, key the human-readable return code printed below it.
Customer
Perfect — gift receipts now print a clean, scannable barcode and the lookup code text. Thanks!
Technician avatar Technician
Summary: When a gift receipt prints without barcode or lookup code, re-enable the barcode element on the gift layout, bind it to a valid return/lookup code, choose Code128 or proper UPC/EAN, and tune thermal printer density/BWR. Add human-readable text and lock the template. Need help wiring it up in your POS? Open the chat.

Quick answer: the accepted fix

Accepted fix when a gift receipt is missing a barcode/lookup code: enable the barcode element on the gift receipt template, bind it to a valid return/lookup code, use Code128 or correct UPC/EAN symbology, and increase thermal print density with proper BWR. Add human-readable text as a backup.


Why gift receipts lose barcodes or lookup codes

Gift receipt barcode suppression is often bundled with “hide prices.” If the POS removes price lines and also hides the barcode element, the receipt prints blank space. Other causes include wrong barcode symbology, missing data in the lookup field, or thermal printer settings (density, scaling) that make codes not scannable.

How to verify the fix

Print a test gift receipt and confirm you see a Code128 or UPC with human-readable lookup code underneath. Scan it with a handheld 1D scanner. If it fails, raise darkness, reduce BWR, and ensure the printed module width is ~0.33–0.4 mm on 203 DPI printers.

Gift receipt barcode — quick troubleshooting tips

Most problems are template suppression, wrong symbology, or poor thermal contrast.

Quick path: enable barcode on gift template → bind to lookup/return code → select Code128 (or UPC/EAN when needed) → tune density/BWR → add human-readable code for manual entry.

Disclaimer: This information is AI-generated and intended for general guidance only. For advice specific to your environment, please consult a verified expert on Whizz-Tech before making decisions.


Getting Started Is Easy

Ask for help, 24/7

Members enjoy round-the-clock access to 12,000+ verified Experts, including POS support, receipt design, and printer tuning.

Expert will respond in minutes

We match you with an Expert who specializes in gift receipt barcodes, lookup codes, and thermal printers.

Save time & money

Prevent returns delays and cashier workarounds by restoring a reliable, scannable barcode on every gift receipt.

FAQ

Why do gift receipts print without a barcode?

Most POS systems suppress barcodes on gift layouts when “hide prices” is enabled. Re-enable the barcode element and bind it to a lookup/return code.

Which barcode type should I use?

Code128 works for alphanumeric return codes. Use UPC-A/EAN-13 only when encoding retail UPCs. Mismatched symbology can print blank.

Scanners won’t read the printed barcode — what now?

Increase print density, lower BWR, ensure adequate height/module width, and use quality thermal paper. Verify the POS isn’t scaling the image.

Can I show a human-readable lookup code?

Yes. Print the lookup/return code text under the barcode (HRI) so staff can key it when a scan fails.

Common gift receipt barcode problems and quick fixes
SymptomLikely causeQuick fix
Gift receipt shows no barcode Template suppression / hidden element Enable barcode on gift layout; bind to lookup code
White space where code should be Wrong symbology or empty field Use Code128; provide fallback to transaction ID
Barcode prints but won’t scan Low density, excessive BWR, scaling Increase darkness, reduce BWR, correct size
Works on Star, fails on Zebra Driver/command differences Render as raster image or switch to native ZPL/ESC/POS per printer

Step-by-step (POS & Thermal Printers)

  1. Duplicate your regular receipt to a Gift Receipt template; enable barcode & lookup code elements.
  2. Select Code128 (or proper UPC/EAN), bind to return/lookup code, add human-readable digits.
  3. Verify the POS sends a barcode image or ESC/POS/ZPL command; avoid print-dialog scaling.
  4. Tune printer: increase density, set BWR=0–2, barcode height ≥ 25 mm, module width ~0.35 mm.

Note for macOS/Browser printing

  1. Disable “Fit to page” and any scaling that shrinks the barcode.
  2. Use the vendor driver (Star/Epson) instead of the generic AirPrint queue for consistent ESC/POS rendering.

Sources

Matt Verified Icon
Matt ● replies in < 1 min
Technician Expert
⭐⭐⭐⭐⭐ Trusted by 27,000+ customers
Avatar
Alex · Expert's Assistant