QR Code Design Guidelines for Packaging
Closient's official position on QR code design for packaging that needs to grade, decode at retail POS, and survive supply chain wear.
Closient generates QR codes that conform to ISO/IEC 18004 and the GS1 Digital Link URI standard. To ensure your codes work reliably across retail POS, industrial scanning, and consumer smartphones, follow the design constraints below when applying QR codes to packaging.
Logos in the data region: not supported
Closient does not support placing logos, marks, or images inside the data region of a QR code. This applies to all packaging use cases, regardless of the requested error correction level.
This is a deliberate position based on three concerns:
- Standards conformance. ISO/IEC 18004 does not provide for image overlays. A logo-embedded code is non-conformant, even when it happens to decode in a particular test.
- Print quality grading. ISO/IEC 15415 grading measurably degrades when the data region is occluded. Many retailers, including Walmart and Costco, enforce minimum grade requirements at receiving. Center logos can drop a code below the threshold.
- Real-world readability. Reed-Solomon error correction is intended to absorb print and wear damage, not designer-introduced obstruction. On packaging substrates with normal dot gain, curvature, and wear, a center logo can push codes past the recoverable damage threshold during their lifecycle.
Branded design treatments that are supported
You can have a branded QR design without sabotaging the data region:
| Treatment | Status | Notes |
|---|---|---|
| Logo adjacent to QR in same artwork | Supported | Place outside the quiet zone with adequate separation |
| Branded frame around QR | Supported | GS1 best practices recommend this approach |
| Brand-colored modules | Supported | Verify contrast meets ISO/IEC 15415 thresholds |
| Custom finder-pattern styling | Supported with verification | Test against multiple decoders before mass production |
| Logo inside data region | Not supported | See above |
Quiet zone
Maintain a quiet zone of at least 4 modules around all sides of the QR code. Do not place logos, text, or graphics inside the quiet zone. Branded frames are acceptable at the outer edge of, or just beyond, the quiet zone.
Color and contrast
Foreground (modules) must be sufficiently dark and background sufficiently light to meet ISO/IEC 15415 contrast requirements. Use a verified verifier or grading tool before production runs. Closient recommends:
- Grade C or better for retail packaging
- Grade B or better for regulated products (food, pharma, medical devices)
Avoid low-contrast color pairings such as gold-on-cream or light blue-on-white even if they decode in lab conditions. They will fail at retail.
Print size
Recommended minimum print size depends on QR version (data density) and scanning environment:
| Use case | Minimum print size |
|---|---|
| Consumer smartphone scanning only | 15 mm × 15 mm |
| Retail POS scanning | 20 mm × 20 mm |
| Industrial / inbound logistics scanning | Per receiver spec, typically 25 mm × 25 mm or larger |
These minimums assume a typical GS1 Digital Link URI of moderate length. Longer URIs require larger print sizes to maintain module size at the limit of scanner resolution.
Use the Print Size Calculator to compute the exact minimum and recommended print size for your specific URI per the GS1 X-dimension specification.
Error correction level
Closient defaults to error correction level M for short URIs and Q for longer ones, balancing data capacity against damage tolerance. We do not default to H unless the use case warrants it (regulated products, harsh environments). Higher ECC levels increase module count and require larger print sizes.
Verification
We recommend verifying every code design at production scale before commissioning a print run:
- ISO/IEC 15415 grading on actual production substrate, not on proof material
- Decode testing across at least three scanner classes: smartphone, retail POS imager, and industrial scanner
- Curvature and angle testing for non-flat packaging (bottles, cans, tubes, pouches)
Closient can provide test pattern packs for verification on request. Contact your account manager.
Use the QR Code Inspector for a deep technical breakdown of any QR code's encoding, mask, and structure before you ship the artwork to print.
Frequently asked questions
Can I put my logo in the QR code if I use ECC level H?
No. See the rationale section above. Higher ECC does not authorize occluding the data region.
Other vendors offer this. Why doesn't Closient?
Other vendors are typically optimizing for "the code scans on a phone in our demo." Closient optimizes for "the code grades correctly at ISO/IEC 15415, decodes on retail POS imagers under Sunrise 2027 conditions, and survives 12 to 24 months of supply chain wear." These are different problems.
Will the QR code on my package fail at Walmart if I use a center logo from another vendor?
It may fail Walmart's grading requirements at receiving, depending on logo size, print quality, and code version. Closient cannot warranty codes generated outside our platform.
Can you make an exception for low-volume marketing materials?
Marketing materials that are not subject to retail POS scanning or grading requirements (such as posters, table tents, business cards) have different constraints. For those use cases, contact your account manager to discuss.
Standards references
- ISO/IEC 18004: QR Code symbology specification
- ISO/IEC 15415: 2D symbol print quality grading
- GS1 General Specifications, current edition
- GS1 "QR Code Powered by GS1 Best Practices" guide