Overview
If you are experiencing issues printing labels — such as nothing happening, incorrect alignment, or labels printing improperly — the fastest way to identify the issue is by checking the label PDF generated by Syncrostore.
This tells you whether the issue is a Syncrostore formatting issue or a printer, driver, or browser issue.
How Syncrostore Generates Labels
Syncrostore generates labels as a PDF file, where each label is placed on its own page and the layout is pre-formatted for the selected label size. What you see in the PDF is exactly what should be printed.
Syncrostore also supports integrated printing using QZ Tray. In both workflows, the generated preview or PDF remains the source of truth for whether the labels were generated correctly.
If each label appears correctly on its own page in the PDF, Syncrostore has already produced a complete and accurate print file.
How to Tell Where the Issue Is
✅ If the PDF Looks Correct
- Each label appears on its own page
- Labels are aligned properly
- No gaps or spacing issues
- Print preview matches the PDF
This confirms Syncrostore has generated the labels correctly. At this point Syncrostore’s role is complete. Any issues after this — nothing printing, labels printing too high/low, misalignment, scaling or shifting — are caused by your printer, printer driver, or browser/system configuration.
This also applies to QZ Tray. QZ Tray forwards print jobs to your locally installed printer using the printer’s existing configuration and does not modify printer settings, label sizes, scaling, calibration, or orientation.
❌ If the PDF Looks Incorrect
- Visible gaps between labels
- Spacing or alignment issues
- Content cut off or formatted incorrectly
This indicates a Syncrostore issue. Please contact support and include a screenshot or copy of the generated PDF and the label type/size you are using.
Barcode Types
Depending on the selected label format and available print area, Syncrostore generates either a Code 128 barcode or a QR code. Stock formats set this automatically (shown by the tag under each tile in the label picker); on a Custom label you choose Code 128 or QR yourself.
For variant items, the barcode encodes the specific variant so it scans straight to the right variant at checkout; for non-variant items, it encodes the item’s ID.
If a barcode appears correctly in the PDF but does not scan after printing, the issue is typically printer scaling, print quality, darkness settings, incorrect label sizing, or driver/printer configuration.
Note: Syncrostore no longer uses DataMatrix codes on labels — the barcode is always a standard Code 128 or a QR code.
Common Causes of Printing Issues (When PDF Is Correct)
- Outdated or unsupported printer drivers
- Older or discontinued printer models
- Browser compatibility issues (especially Chrome updates)
- Incorrect label size or printer configuration
- Print scaling settings (e.g., “Fit to Page” / “Fit to Printable Area” enabled) — the #1 cause of inkjet-sheet rows drifting down the page
- On a Custom label, the wrong Printer type (iDPRT & other vs. Dymo LabelWriter)
- Differences between Mac and Windows environments
Troubleshooting Steps
If your PDF looks correct but printing is not:
- Reinstall or update your printer driver.
- Print a standard PDF outside of Syncrostore.
- Ensure scaling is set to 100% (no “Fit to Page”).
- Try a different browser.
- Verify label size and printer settings (paper size matches the label; rotation 0 on non-Dymo thermal printers).
- On a Custom label, confirm the Printer type matches your printer.
- Contact your printer manufacturer or a local IT professional if needed.
- If using QZ Tray: verify it’s running, confirm drivers are installed, verify your default label size in the OS printer preferences, and test printing outside of Syncrostore first.
If integrated printing continues to cause issues, you can uninstall or disable QZ Tray and return to the standard PDF printing workflow.
Scope of Support
Syncrostore support can assist with verifying label PDFs are generating correctly and confirming print jobs are triggered.
Syncrostore support cannot fully manage or configure local printer hardware, printer drivers, operating system printer settings, browser-to-printer communication, or manufacturer-specific printer utilities.
Summary
The generated PDF is the source of truth.
- If the PDF is correct → the issue is outside of Syncrostore.
- If the PDF is incorrect → contact Syncrostore support.