How to Embroider a QR Code That Actually Scans

You can embroider a QR code, and it will scan. A stitched code just fails for different reasons than a printed one does, because thread spreads and fabric stretches, and a margin that looked fine on screen gets eaten by a satin border. When an embroidered QR code won't scan, the cause is almost always one of four things: the code was too small, it held too much data, the colors didn't contrast enough, or nobody scanned a sample before the order went through.

This guide works through each of those, then covers cross stitch and 3D puff, so your code works on the first run.

Why stitched QR codes fail

A phone reads a QR code by finding the three corner squares, then sorting every small square in between (the "modules") into dark or light. Ink gives the camera crisp edges to work with. Thread gives it soft ones.

Dense fill stitches pull the edges of a shape inward in one direction and push them out in the other, so a square module can come out slightly rectangular and neighbors can merge. Shrink the code far enough and there aren't enough stitches left to form a clean square at all; the pattern turns to mush.

Light is the next problem. Shiny thread reflects it, and under a bright lamp some dark modules read as light.

The one people miss is the quiet zone. QR codes need an empty margin around them, and a patch border or a second logo placed too close breaks the scan more often than anything inside the code.

None of this means embroidery is a bad idea. The design simply has to give the thread more room than ink would need.

Step 1: Keep the link short

People skip this step more than any other, and it matters most.

A QR code holding more data needs more modules. The smallest QR code is 21 × 21 modules, and the grid grows as the content gets longer. On paper that hardly matters, but in thread it decides whether each module is a solid little square or a few loose stitches.

Compare two codes stitched at the same 2-inch width:

Two millimeters is comfortable for a fill stitch. At 1.2 mm you're gambling.

So before you design anything:

• Point the code at a short URL and drop any tracking parameters you don't need.
• Skip vCards with full address blocks. A link to a contact page carries far less data than the contact details themselves.
• Use a short link you control, or a dynamic QR code. Either way the code holds the same short address, and you can change where it points later. That matters more on fabric than anywhere else, since once a code is stitched onto 200 caps you can't reprint it if your website changes.

Step 2: Generate the code with plain settings

Embroidery rewards boring QR designs. Fancy module shapes that look great in print make digitizing harder and scanning less reliable.

Stick with square modules. Dots and rounded shapes are hard to stitch cleanly at small sizes. Keep the corner squares (the "eyes") square and solid. Use one dark color on a light background, with no gradients.

Leave the logo out of the middle unless the code is large. A center logo works by covering part of the pattern and leaning on the code's built-in error correction, and embroidery already uses up some of that margin. Don't spend it twice.

Export as SVG. Your digitizer (or your embroidery software) can trace a vector file exactly instead of guessing from a blurry PNG.

The free QR code generator gives you square modules in solid colors with an SVG download. It also runs a scan check before you download, so you start from a file that's known to scan.

Step 3: Pick a size that leaves room for the thread

There's no single official minimum for embroidered codes. Treat these numbers as starting points and confirm them with a sew-out.

For print, the common rule is about 2 cm (0.8 in) for close-range scanning (QR Codes Unlimited). Embroidery needs more than that because the edges soften. With a short link (around 25 × 25 modules), these sizes work well:

Then add the quiet zone, a clear margin of at least four modules on every side (QR Codes Unlimited). On a 25-module code that works out to about 16% of the code width on each side. Keep border stitching and text out of it, and logos too.

Step 4: Digitize it like a set of blocks, not a picture

Auto-digitizing a QR code image usually produces a tangle of tiny objects with jump stitches and trims everywhere. You'll get a cleaner file by building it yourself:

1. Use fill stitches, not satin. Tatami or a similar fill keeps modules flat and square, while satin columns are meant for narrow shapes and lettering.
2. Merge touching modules. Neighboring dark modules can be one fill shape, and fewer objects mean fewer trims and less distortion.
3. Keep one stitch direction across the code, so the light catches every module the same way.
4. Go easy on pull compensation. You need some, but too much makes dark modules swell into the light ones.
5. Leave the light modules unstitched and let the fabric (or a light patch base) be the background.

Some embroidery programs have a built-in QR tool that builds the stitch objects for you. If yours does, it usually beats tracing a picture.

Step 5: Choose colors the camera can read

After size, contrast decides more scans than anything else.

Dark thread on light fabric is the safe choice: black or navy on white, cream or light gray. A white code on a black cap looks sharp, but plenty of scanner apps won't read inverted codes, so if the garment is dark, stitch the code onto a light patch instead.

Thread finish matters too. Glossy rayon can glare under store lights, and a matte or standard polyester is easier on cameras.

Tone-on-tone is the trap. Navy on black or gray on white can look great on the garment and still won't scan.

Where embroidered QR codes work best

Patches. These are the easiest. The surface is flat and the base fabric is stable, and you can sew or iron the patch onto anything, including curved caps and stretchy knits. If you're unsure about a garment, make a patch.

Caps are harder, because the front panel curves and a curve bends the grid. Keep the code small and centered on a flatter area, use a patch, or put it on the side or back panel. Structured caps hold their shape better than unstructured ones.

Polos and aprons (work shirts too) suit staff uniforms well, with a code that opens the menu, a review page or a booking link. On knits, use a cutaway stabilizer so the fabric doesn't stretch and warp the grid.

Tote bags and other canvas items are firm and flat, usually in a light color, which is ideal. A canvas tote is probably the most forgiving surface of all.

Avoid ribbed knits, fleece and towels. Their texture breaks up the modules no matter how well the file is digitized.

What about 3D puff embroidery?

3D puff stitches over a foam layer to raise the design off the fabric, and it's a popular look on caps right now. Don't use it for the QR code itself.

Puff works best on bold shapes and thick lettering. Embroidery software makers suggest columns of at least 3 mm for puff (Wilcom), and QR modules are smaller than that. On top of that, raised edges cast shadows that the camera can read as dark modules.

Puff does work beside the code, though. Put a puff brand name above a flat-stitched QR code on a cap front and you get the raised look plus a code that scans. Just keep the puff out of the quiet zone.

Cross stitch QR codes

Cross stitch suits QR codes surprisingly well, because the fabric already is a grid. Map each module to a block of stitches; 2 × 2 stitches per module is a good default.

At that ratio a 25 × 25 code becomes 50 × 50 stitches, which on 14-count Aida is about 3.6 inches square before the margin. Leave at least 8 unstitched squares (four modules) around every side, and use full crosses rather than half stitches so each module is solid.

Generate the code first, then count the modules off the image or turn it into a chart. A short link keeps the chart small enough to finish in an evening.

Test before the full run

Never approve a run of embroidered codes from a screen proof. Stitch one sample on the actual garment or patch material, then:

1. Scan it with at least two phones, one iPhone camera and one Android camera app.
2. Scan from arm's length and from a slight angle, not just head-on.
3. Try it under normal room light and under a bright lamp to check for glare.
4. If it's a garment, wash the sample once and scan it again.

If it scans slowly or only from one angle, make it bigger or shorten the link before you change anything else. Those two fixes solve most problems.

Frequently asked questions

Can you embroider a QR code?

You can, and it will scan reliably if you stitch it with fill stitches in dark thread on a light fabric at roughly 2 inches wide or more. Keep the link short and test a sample before the full order.

What size should an embroidered QR code be?

With a short link, aim for about 1.5 to 2 inches on caps and patches and 2 to 2.5 inches on a shirt chest, plus a clear margin of four modules around it. Longer content needs a larger code.

Will an embroidered QR code still work after washing?

It usually will, as long as it was stitched on a stable fabric with a proper stabilizer. Fabric that shrinks or puckers can distort the grid, so wash a sample once and scan it before you commit to a large order.

Can I put my logo in the middle of an embroidered QR code?

Only on large codes, and test carefully. A logo covers part of the pattern and relies on error correction, which embroidery already eats into. On small codes, stitch the logo beside the code instead.

Should I use a static or a dynamic QR code for embroidery?

For anything you'll stitch in quantity, a dynamic code is the safer pick. It holds a short link, which means fewer and bigger modules, and you can change the destination later without remaking the garments. A static code is fine for one-off gifts or links that will never change.

Why won't my embroidered QR code scan?

Start with size and link length, since those cause most failures. After that, check whether the thread contrasts with the fabric, whether anything sits inside the quiet zone, and whether the surface is curved or stretched.

Make the code first

Every embroidery QR code project starts with a clean, scannable file. Create yours in the QR code generator with square modules in a dark color, download the SVG, and send it to your digitizer or load it into your embroidery software. If the code is going onto uniforms or merchandise, put a short link behind it, so the stitched code still works next year, even if your website changes.