pixie.codes pixie.codes
Migration guide / design + scannability

Style the code, then gather scoped scan evidence

Brand expression and scannability are compatible, but only if styling choices stay subordinate to quiet zones, contrast, payload size, print conditions, and real confirmation checks before packaging lock.

Quiet zones and contrast remain non-negotiable Styling needs confirmation, not taste-based approval Packaging tests matter more than on-screen mockups

Design-review evidence map

Scannability review spans six independent dimensions

A digital design screen can help identify risk. It cannot certify packaging, establish target-POS performance, or approve release without the corresponding evidence.

  • data_conformance

    Data conformance

    Payload-scoped

    Keep canonical GS1 Digital Link checks separate from module styling and resolver behavior.

  • qr_correctness

    QR correctness

    Grid-scoped

    Verify exact encoder-declared bytes and QR structure against the displayed subject grid.

  • predictive_screen

    Predictive screen

    Digital screen only

    Record palette, geometry, overlay, model, thresholds, source set, and run time.

  • physical_print_quality

    Physical print quality

    Indeterminate until observed

    Test the final size and materials under the intended print and finishing process.

  • pos_performance

    POS performance

    Indeterminate until observed

    Use the matching specimen and named target-device acceptance protocol.

  • resolver_behavior

    Resolver behavior

    Time-scoped

    Observe routes and linksets independently with request scope, configuration, time, and expiry.

No aggregate PASS: a styled code can have favorable digital evidence while physical, POS, material, or resolver evidence remains indeterminate.

What actually breaks scan performance

The standard is rarely the problem. Most failures come from design or production decisions that shrink scan margin below what real devices and conditions can tolerate.

Risk Why it hurts Risk-reducing posture
Low contrast Modules and background become harder to distinguish under glare, shadow, or cheaper cameras. Maintain stronger contrast than the aesthetic minimum.
Eroded quiet zones Nearby artwork interferes with detection and decoding. Protect the clear area around the symbol as a hard packaging requirement.
Busy backgrounds or embedded imagery Visual noise competes with the code structure and finder patterns. Keep the code isolated enough to remain visually distinct on pack.
Late payload growth The symbol becomes denser, often without revisiting size, print, or testing assumptions. Lock payload rules early and re-test if they change.

How to style with explicit risk controls

A styled QR code is acceptable only when the styling respects the code’s functional structure and still performs after print. That means each design choice needs operational accountability.

Do this

Style with explicit scan margin in mind

  • Keep quiet zones, contrast, and payload size as hard constraints.
  • Test the final printed pack rather than relying on clean digital mockups.
  • Re-run validation when module styling, color, or payload density changes.
Avoid this

Do not treat visual approval as readiness

  • Softening modules or reducing contrast without empirical confirmation.
  • Embedding the code inside busy imagery, seams, folds, or reflective areas.
  • Approving the art before device, scanner, and packaging tests are complete.
Scan test matrix
  • Current iOS and Android devices across more than one camera generation.
  • Retail or warehouse scanners where those scan paths matter.
  • Low light, glare, motion, shelf-distance, and angled scans.
  • Multiple print runs, substrates, and packaging finishes where practical.
Owner decision threshold

If the styled version only succeeds under ideal lighting, fresh print, or careful user behavior, it has not met a credible physical/POS acceptance contract. Keep the exact test scope and owner decision explicit.

Example of a conservative GS1 QR baseline for scoped scan testing
A conservative baseline is usually the right first print choice. The goal is not to remove brand expression. The goal is to earn the right to push styling only after the scan margin is understood.
Why tooling matters

Keep design edits, scan checks, and approval evidence together

Styled QR codes should not be approved by appearance alone. pixie.codes helps teams make fine-grained visual changes while keeping warnings, scan results, and packaging review notes tied to the same approval record.

What to test before packaging lock

A useful test plan is short, repeatable, and grounded in real conditions instead of lab perfection.

Device matrix
  • Current iOS and Android phones
  • Any relevant retail or warehouse scanners
  • Different scan distances and approach angles
  • Motion, low light, and glare scenarios
Packaging matrix
  • Final substrate and print process
  • Glossy and reflective surfaces
  • Curved packs and small-format packs
  • Multiple print runs where possible
Approval rule

The sign-off question is not whether the design looks polished. It is whether the final printed code still scans with enough margin across the real conditions the product will face.

Frequently asked design questions

Can we make the code look branded?

Yes, but only if the branding treatment is validated against real scan behavior. Design approval without scan confirmation is not enough.

What should we treat as non-negotiable?

Quiet zones, contrast, adequate size for the payload, and validation on the actual printed pack.

Can we decide from screen mockups alone?

No. On-screen approval is a weak proxy for printed behavior, especially on glossy, curved, or small packs.

Where should we go next?

If your next question is about pack strategy, read the dual-marking guide. If your next question is execution and validation workflow, use the implementation tools and pilot checklist.

Next step

Turn styling decisions into a testable approval workflow.

Use the design guide to set your non-negotiables, then move into QR generation and pilot validation with the right evidence expectations already in place.