A printed QR code not scanning is a production problem to investigate before you reorder the entire batch. First separate two questions: can the phone read the symbol, and does the destination work after it is read? A crisp code that opens the wrong page needs a different correction from one the camera cannot recognise at all.
This troubleshooting guide is for Kenyan businesses using QR codes on business cards, flyers, product labels and displays. If you need to generate a WhatsApp code first, use Mocky's WhatsApp QR tool and follow the creation guide. The checks below focus on the finished printed item.
Identify exactly where the scan fails
Try the original digital code and the printed version using the same phone. Record what happens in each case. Does a link appear on screen? Does tapping it open a page? Does the page load but show the wrong content? Those observations are more useful than telling a designer that the QR is broken.
Use more than one representative phone where practical. This helps distinguish a single-device issue from a problem that several customers are likely to encounter. Test the print in the lighting and position where it will actually be used, rather than only beneath a bright desk lamp.
Keep the affected printed sample and its final artwork file. If you only retain a photograph of the sample, you may lose useful information about the physical finish or size. Ask the printer or designer to assess the actual item before approving a full reprint.
Check the clear space around the symbol
A QR code needs a clear border called a quiet zone. DENSO WAVE's QR guidance specifies a four-module margin around a standard QR symbol. A module is one of the small squares making up the pattern. The border is functional space, not spare decoration to fill with a slogan.
Inspect the final layout, not just the exported code on its own. Text, frames, photographs or background patterns may have been placed too close when the design was assembled. A generator can provide a suitable border that is later cropped out during layout or trimming.
Ask the designer to preserve the code's clear area when correcting the file. Do not simply add a decorative outline and assume the requirement has been met. Review the complete artwork with the print specification so the intended border survives production and finishing.
Review size, detail and image quality together
A code that reads on a large screen may fail after being reduced to a small corner of a business card. Check the actual printed dimensions and the size of the individual squares. Avoid choosing a universal minimum size without considering the code, printing process and intended viewing distance.
Use the original exported asset rather than a screenshot copied through a messaging app. Repeated compression and resizing can make the boundaries less clear. Ask the designer and printer to check whether the selected file remains suitable at the final output size and whether the export process has softened it.
Print a representative sample before ordering a batch. If a code is enlarged to troubleshoot it, test that version physically too. A larger desktop preview alone cannot demonstrate that a particular paper, finish and placement will work for the intended customer interaction.
Check the physical surface and viewing conditions
Look at the sample where customers will encounter it. Gloss, reflections, a curved container or a position behind a counter can change how easy it is to point a camera at the code. These conditions are not visible in a flat design proof.
For packaging, test the code on the actual assembled package. A symbol printed across a fold, placed near a curved edge or partly obscured by wrapping may be difficult to use. For a poster or banner, check that a person can reach a sensible scanning position without stepping into traffic or leaning across furniture.
If the print will be displayed behind glass, assess it in that position. Compare different angles and ordinary lighting conditions. Record the circumstances that make it fail so the designer can distinguish a layout issue from a placement problem. Moving a display may sometimes be part of the solution, but verify the revised arrangement before declaring the problem resolved.
Inspect colour, overlays and decorative changes
Check whether the final code was recoloured, placed over a busy background or altered with a logo overlay. Brand styling should be assessed against scanning performance on the finished print. A design that looks attractive in a mockup is not sufficient evidence that the decorated symbol will read reliably.
Ask the designer to compare the styled version with a simple high-contrast reference. Change one feature at a time during diagnosis so you can identify which revision actually helps. Do not remove several details, change the destination and resize the code simultaneously, then assume you know what caused the original failure.
Keep a record of the approved corrected version. If the printer receives both the old and new artwork, state clearly which file supersedes the other. A good diagnosis still results in a bad batch if an outdated asset is accidentally sent back into production.
Verify the destination after a successful read
When the camera recognises the symbol, inspect the address or action it proposes before continuing. Confirm that it matches your intended business destination. Test the page on a phone and check the actual next step, such as viewing a menu or opening the correct WhatsApp conversation.
For a WhatsApp code, verify the business number and any prepared message. Do not send an unnecessary test enquiry just to prove that the conversation window opens. If your team needs an actual message-delivery test, coordinate it internally so it is not mistaken for a new customer lead.
If the code uses a redirect service or a changeable destination, identify who controls that service and whether any subscription is involved. Keep the account responsibility with the project records. A printed symbol can remain readable while a destination stops working or is changed to the wrong page.
Approve the correction using the intended print specification
Ask for a corrected proof and a physical sample where practical. Keep the final size, material and finishing representative of the batch. A plain paper test can help diagnose the layout, but it does not fully establish performance on a shiny label or a display behind glass.
Use a short acceptance record: artwork version, printed dimensions, material, placement, devices used and observed destination. State the intended action beside the code, such as viewing the service menu. The person signing off should confirm both scanning and the usefulness of what opens.
Repeat the check after the batch arrives. Select examples from the supplied items and inspect whether finishing has changed the code area. If a problem appears, retain samples and contact the supplier with the recorded evidence. Avoid ordering another full run before the cause and correction have been agreed.
A troubleshooting sequence your team can follow
Work through the checks in this order:
Compare the digital original with the actual printed code.
Record whether recognition or the destination is failing.
Inspect the clear border and any cropping.
Check final dimensions and the quality of the placed asset.
Test the actual surface, position and lighting.
Compare styling with a simple reference version.
Confirm the destination and intended customer action.
Approve a representative corrected sample before the full batch.
For print production help, send the original asset, final artwork and photographs through the branding and print quote form. Explain where the code will be used and what your tests showed. The digital printing team can then discuss a production specification rather than guessing from a compressed screenshot.
Frequently asked questions
Does a successful scan on my laptop prove the print is ready?
No. Test a sample at the intended printed size and on a representative surface. The final layout, border, material and viewing conditions can differ from the digital original.
Should I regenerate the QR code immediately?
First identify the failure. If the symbol reads but opens the wrong destination, correct that issue. If recognition fails, inspect the print and layout before changing the encoded information. Keep the original and revised files so the diagnosis remains traceable.
Can I put a logo in the centre?
Ask the designer to assess and physically test the proposed version. Do not assume a decorative change is harmless because another code used it successfully. Approve the actual printed design rather than a generic example.
What if the printed batch already exists?
Keep representative samples, verify the destination and share the evidence with the designer or printer. Discuss the correction and replacement options for that job. A diagnosis should precede another production order so the same problem is not repeated.
