A QR code that fails to scan is worse than no code, especially once it is printed on a flyer or a menu. Almost every failure comes from a few preventable mistakes: content typed in the wrong format, low contrast, a missing quiet zone, or a file that was enlarged until it blurred. The QR Code Generator gives you the controls to avoid all of them. This guide goes through them in the order you meet them.
Step 1: the content, typed in the right format
Under What is it for? you choose Website URL, Email, Phone, Wi-Fi, SMS or Text. One thing to know: choosing a type fills the Content box with an example, and the code is made from exactly the text that is in the box. Nothing is added or reformatted for you. So type the content in the format a scanner expects:
| Type | What the Content box should contain |
|---|---|
| Website URL | https://yoursite.com/page (include https://) |
mailto:name@example.com | |
| Phone | tel:+15551234567 (with the country code) |
| Wi-Fi | WIFI:T:WPA;S:NetworkName;P:Password;; |
| SMS | smsto:+15551234567:Hello |
| Text | Any text |
If you type only an email address without mailto:, a phone will treat it as plain text and will not offer to write an email. Test every code before you print it.
Step 2: keep the content short
A QR code with more characters has more, smaller squares, which are harder to read. A short link makes a simpler, more robust code. If your URL is long, use a short, clean address on your own site, for example a page made to redirect, instead of a link with long tracking parameters. The code does not expire, because it stores the content itself and no server is involved, but that also means you cannot change where a printed code points. If you may want to change the destination later, point the code at a page you control and change the page.
Step 3: size, margin and error correction
- Size: the presets are 128, 256, 512 and 1024 pixels, and the custom slider allows 128 to 1024. Bigger sizes give a sharper image for print. For a printed code, the physical size matters more than the pixel count; a code printed at about 2 cm square is a typical minimum for scanning at arm's length, and bigger is safer.
- Margin: from 0 to 20 modules, with a default of 4. This is the blank border around the code, called the quiet zone. Scanners need it. Do not set it to 0 unless the code will be placed on a blank area with its own border.
- Error correction: Low (7%), Medium (15%), Quartile (25%) and High (30%). The percentage is how much of the code can be damaged or covered and still be read. Higher levels make a denser code. Medium is fine for screens. Use High for printed codes that may get scuffed, folded or dirty.
Step 4: colors that keep it readable
You can set the Foreground color and Background color. Scanners need strong contrast, and the usual convention is dark on light. A dark foreground on a light background is the safest option. Avoid:
- Light colors on a dark background (inverted codes). Some readers cannot decode them, although the scanner on this site tries inverted codes for images.
- Low-contrast pairs such as yellow on white or two similar shades.
- Gradients or patterns behind the code.
Check a color pair with the Color Contrast Checker. A ratio well above the 4.5:1 text threshold is a good habit for QR codes.
Step 5: PNG or SVG
Press Download PNG or Download SVG. The preview matches the file. Use PNG for web pages, documents and chats; use SVG for print, signage and logos, because it scales to any size without blur. If your printer asks for a bitmap, export the PNG at 1024 pixels, or convert the SVG with SVG to PNG at a larger scale.
Test before you print
- Scan the code on screen with two different phones, or with our QR Scanner.
- Print one copy at the real size and scan that, not just the screen.
- Check from the distance people will actually scan from.
- If it fails, increase the size, raise the error correction, shorten the content or increase contrast.
For a Wi-Fi code, the password is stored in the code in readable form; anyone who scans it sees it. Do not put it on a poster in public if the network is private.
Common problems
- The code opens as text, not a link. The URL is missing
https://. - The code is blurry when printed. You used a small PNG. Download SVG or the largest PNG.
- It scans on a screen but not on paper. The printed size is too small, or the margin was set to 0.
- The phone shows the wrong network. Check the spelling and the case of the network name and password; they are case-sensitive.
A worked example: a Wi-Fi code for a guest room
Choose Wi-Fi, replace the example in the Content box with WIFI:T:WPA;S:GuestNet;P:your-password;; using your own network name and password, and keep the margin at its default of 4. Choose Quartile or High error correction, since the sign will be handled. Set dark foreground on a white background, download the SVG, and print it at a comfortable size, for example the width of a postcard. Scan it with two phones from about arm's length. If one of them hesitates, print it larger.
Where to put the code
Place printed codes on flat, matte surfaces. Curved or glossy surfaces cause glare and distortion. Leave a clear space around the code, equal to the margin you set, and do not overlay it with text or decoration. Add a short line of text near the code that says what it is for, so people know whether it is worth scanning.
FAQ
Is it free and does it expire?
It is free, with no watermark. The code holds the content itself, so it never expires.
Is my content sent to a server?
No. The code is generated in your browser.
Can I add a logo?
This tool makes a plain code with colors, margin and size. It does not place a logo in the middle.