← All blog posts

QR Code Generator — the complete guide

WhiteUI · A plain-English guide to the QR Code Generator

A QR code is a picture of text that a phone can read, and this guide covers every part of the QR Code Generator: the text box, the three image sizes, the four error-correction levels, the version line under the code, the PNG download, and how to print a code that scans first time. There is no account, no upload and no cost, because the code is drawn in your browser.

At a glance

Largest size: 1,024 px on a 0 to 1,024 px scale0 px512 px1,024 px1,024 px is the largest size; 256 px is the default
The largest image size is 1,024 pixels, at the end of the scale. The default is 256 pixels, and 512 pixels sits halfway.

The text box

The box labelled “Link or text” holds what the code will say, up to 500 characters. It starts with “https://whiteui.com”, which is 19 characters long. Type a full web address, starting with “https://”, when you want a phone to open a page, and type plain words when you want a phone to show a message. The code updates as you type, so you can watch the grid change and read the version line underneath it.

The three image sizes

The size buttons are 256 px, 512 px and 1,024 px, and 256 px is the default. The size is the width of the downloaded PNG, not the amount of text the code holds. For the default code, version 2 with 25 × 25 modules, 256 px gives a canvas 250 px across, because each module is 10 px wide; 512 px gives 500 px across, with each module 20 px wide; and 1,024 px gives 1,000 px across, with each module 40 px wide. Use 256 px for a screen, 512 px for a handout and 1,024 px for a poster.

The four error-correction levels

The error-correction buttons are L, M, Q and H, and M is the default. L recovers about 7 percent of damaged modules, M about 15 percent, Q about 25 percent and H about 30 percent. Higher correction makes the code tougher, but it leaves less room for your text, so a long message at H may need a bigger version than the same message at M, or may not fit at all. For a code printed on paper and handled gently, M is enough; for a label on a parcel or a sign outdoors, H is worth picking.

Reading the version line

Under every code the tool prints a line such as “Version 2 • 25 × 25 modules • error correction M (~15% recoverable) • 19 characters.” The version is the grid size, from version 1 at 21 × 21 modules to version 40 at 177 × 177, and the module count follows modules = 4 × version + 17. The tool picks the smallest version that fits your text at your level, so the line tells you how dense your code is. A short link gives a small version and an easy scan; a long message gives a bigger version and needs a bigger print.

Downloading and printing

Click “Download PNG” and the file is saved as qr-code.png. Print it at least a few centimetres across, and bigger for a dense code or a code that will be scanned from a distance. Print one copy first and scan it, because a print that is too light, too small or on glossy paper can fail even when the screen version scans perfectly. The code never expires, so a code for a live page keeps working for as long as that page stays up.

What the tool does not do

The tool does not check your link, track scans, or store your code anywhere, because it never sends your text to a server. The library that does the encoding, qrcode-generator 1.4.4, is bundled into the page and runs in your browser. If you need to know how many times a code was scanned, you need a link shortener with analytics, not a QR generator, and that is a different tool with an account attached.

The common mistake

People pick the biggest size and the highest error level for every code, thinking bigger and tougher is always better. For a short link on a screen, 256 px and M already scan perfectly, and 1,024 px with H only makes a denser grid that is harder to print small. Match the settings to the job: a bigger size for a bigger print, and a higher level for a code that will be handled roughly.

Frequently asked questions

What are the three image sizes in the QR Code Generator?

256 px, 512 px and 1,024 px, with 256 px as the default. For the default code, 256 px gives a 250 px canvas, 512 px gives 500 px, and 1,024 px gives 1,000 px.

What are the four error-correction levels?

L recovers about 7 percent of damaged modules, M about 15 percent, Q about 25 percent and H about 30 percent. M is the default.

How do I read the version line under the code?

It shows the version, the module grid, the error level and the character count. For the default link it reads Version 2, 25 by 25 modules, M, 19 characters.

Does the QR Code Generator track scans?

No. It never sends your text to a server, so it cannot count scans. For scan counts you need a link shortener with analytics.

Does a QR code made here expire?

No. The code is just your text drawn as squares, so it works as long as the link or text it holds is still valid.

More guides on the QR Code Generator

Try it yourself

Try the QR Code Generator — free, in your browser.

Open the QR Code Generator