The wall behind the counter at my local coffee shop has a laminated card with the WiFi password printed in a font nobody can read from more than a foot away. I have watched dozens of people squint at it, type it wrong, get an error, and try again. When I fitted out the little meeting room in our office, I refused to repeat that. I printed a WiFi QR code instead, stuck it by the door, and the number of "what is the WiFi again?" messages dropped to zero overnight. That experience is why Toolz now has a dedicated WiFi QR code generator, and this guide is everything I worked out while building and testing it.
TL;DR: A WiFi QR code stores your network name, password, and security type in the standard
WIFI:format that iPhone and Android read natively. A guest scans it with the camera app, taps a prompt, and joins without typing anything. This tool builds the payload, escapes tricky characters, and encodes it entirely in your browser, so your password is never uploaded. Print it as SVG for signage or PNG for a screen, and it never expires.
I build SaaS products on Laravel and React, and I have a soft spot for small tools that quietly remove friction. A WiFi QR code is exactly that. It solves a problem everyone has, it costs nothing, and once you understand the format there is genuinely nothing to it. Let me walk through how it works, how to use it, and the handful of details that decide whether the code scans on the first try or frustrates everyone.
What is a WiFi QR code?
A WiFi QR code is a QR code that encodes the credentials for joining a wireless network. The symbol itself is standardised as ISO/IEC 18004; the WIFI: payload inside it is a de facto convention rather than part of that standard, which is why behaviour differs between Android and iOS. Instead of pointing at a website, the code carries a short structured string describing the network name, its password, and how it is secured. When a phone camera reads that string, the operating system recognises the format and offers to connect to the network directly, filling in the password for the person so they never see or type it.
The idea has been built into phones for years. Apple added camera-based WiFi QR scanning in iOS 11, and most Android phones running Android 10 or later do the same through the default camera app or the WiFi settings screen. That native support is the whole reason the technique is worth using: you are not asking guests to install a special reader, you are relying on a feature their phone already has.
What makes this different from writing the password on a card is not just convenience, it is accuracy. Passwords for guest networks tend to be long strings of mixed case and symbols, exactly the kind of thing humans mistype. A scan transfers the credential byte for byte, so there is no ambiguity between a capital I, a lowercase l, and the digit 1. If you have ever generated a strong key with a password generator and then watched someone try to type it by hand, you already understand the appeal.
How does the WiFi QR format actually work?
Under the black-and-white squares is a plain text string. For WiFi it follows a compact format that looks like this:
WIFI:T:WPA;S:MyNetwork;P:MyPassword;;
Each field is a letter, a colon, a value, and a semicolon. T is the authentication type, S is the SSID (the network name), and P is the password. The whole thing is wrapped in WIFI: at the front and closed with a double semicolon at the end. That trailing ;; is not decorative. Some Android parsers drop the final field if the second semicolon is missing, so the generator always includes it.
There is one more field worth knowing about. A hidden network, one that does not broadcast its name, needs H:true added so the phone knows to actively probe for it rather than wait to see it in a scan. Without that flag, a phone can have the correct name and password and still fail to connect to a hidden SSID.
The trickiest part of building this string is escaping. The characters \, ;, ,, ", and : all mean something to the format, so if your SSID or password contains any of them, they have to be escaped with a backslash. A password like p@ss;word would otherwise be read as two fields and break the join. The WiFi QR code generator handles this automatically, so you can paste a password exactly as it is and trust that the encoded version is faithful. This is the same escaping logic the broader QR code generator uses for its WiFi preset, lifted into a focused tool.
What happens after the string is built?
Once the WIFI: string exists, it is encoded as a QR matrix following ISO/IEC 18004, the international standard that defines the QR Code symbology. The text is converted to UTF-8 bytes, wrapped in Reed-Solomon error correction so the code survives smudges and creases, laid out into modules with the finder patterns in the corners, and masked so the pattern is balanced and easy for a scanner to lock onto.
That encoding step is identical to encoding any other QR payload, which is a good thing: it means a WiFi QR code is not a special kind of code that needs a special reader. It is an ordinary QR code whose content happens to be network credentials, and any scanner that reads QR codes at all can read the text. Whether the phone then offers to join the network depends on the operating system recognising the WIFI: prefix, which every current version of iOS and Android does.
Because the credentials are baked into the pattern, the resulting code is static. There is no short link in the middle pointing at a server that could go offline, no account behind it, and nothing tracking how many times it has been scanned. That is a meaningful privacy property, and it is one I care about enough that I wrote more about it in the data privacy guide. Your password sits inside the image and nowhere else.
How do I create a WiFi QR code?
The tool keeps this to four short steps.
Step 1: Enter the network name exactly
Type the SSID precisely as it appears on your router, including capitalisation and any spaces. SSIDs are case-sensitive, so HomeWiFi and homewifi are two different networks as far as the phone is concerned. If the code will not connect later, a mistyped or wrong-case SSID is the first thing to check.
Step 2: Add the password and pick the security type
Enter the WiFi password, then choose the security mode. Pick WPA for any WPA, WPA2, or WPA3 network, which covers virtually every router made in the last decade. Choose WEP only for genuinely old hardware that still uses it, and Open for a hotspot with no password at all. If you are not sure, the label on the router or its admin page will tell you the security mode. There is a show/hide toggle on the password field so you can confirm you typed it correctly without leaving it exposed on screen.
Step 3: Tick "hidden" if the network does not broadcast
If your SSID is hidden, enable the hidden-network option so the payload includes the H:true flag. Most home and guest networks broadcast normally and do not need this, but hidden networks will not reliably connect without it.
Step 4: Style it and download
Raise the error correction level if the code will be printed small or placed behind glass, set the foreground and background colours to match your signage while keeping strong contrast, and adjust the quiet-zone margin. Then download a vector SVG for print or a PNG for a screen. Both come out with no watermark. Before you order a batch of anything, scan the printed version with two or three different phones.
Which error correction level should I choose?
QR codes carry redundant data so they can still be read when part of the code is dirty, torn, or covered. The four levels, L, M, Q, and H, recover roughly 7, 15, 25, and 30 percent of a damaged code respectively. Higher levels add more redundancy, which makes the code denser and slightly larger for the same amount of data.
For a WiFi code the payload is short, so you have room to be generous. Level M is a sensible default for a clean screen or a well-printed card. Step up to Q or H when the code will live somewhere hostile: a laminated card that gets handled, a window sticker exposed to sun, a small print on the corner of a flyer, or any design where you want to drop a logo into the middle. The logo trick specifically needs level H, because the error correction is what lets the scanner reconstruct the modules your logo covers. Keep any logo under about a quarter of the code area and centre it.
Where should I actually use a WiFi QR code?
The obvious home is guest WiFi in any space where people come and go. Cafes, restaurants, and bars can put it on the table or the counter. Hotels, guesthouses, and short-term rentals can print it in the welcome folder or frame it on the wall, which saves the host from repeating the password to every new arrival. Offices can stick one in the reception area and one in each meeting room so visitors get online without bothering anyone.
It works just as well at home. Put one on the fridge or inside a kitchen cupboard and family, friends, and the occasional tradesperson can join without you reciting a twenty-character key. I keep one in a drawer for exactly this. Events and conferences use them on badges and signage so attendees connect to the venue network in seconds, and classrooms use them so a room full of students joins at once instead of one at a time.
The common thread is that the network is meant to be shared. A WiFi QR code makes the credential trivially easy to pass on, which is the point for guest access and a reason to keep codes for private networks out of public view. Anyone who can photograph the code can read the network, so treat a printed code with the same care you would treat the written password.
Is it safe to make a QR code for my WiFi password?
With a client-side tool, yes. The encoding here happens entirely in your browser using JavaScript. Your SSID and password are turned into a QR matrix on your own device and never sent anywhere, so there is no server that could log or leak them. You can confirm this by opening your browser network tab and watching: generating the code makes no network request, and the tool keeps working with your connection switched off once the page has loaded.
The thing to be careful about is not the tool, it is the printed result. A WiFi QR code is a plaintext credential in visual form. That is exactly what you want for guest access, and exactly why you should not tape a code for your private main network to the outside of your front door. For anything sensitive, use a separate guest network with its own password, which most routers can create in a couple of clicks, and share only that. Good WiFi hygiene, like using a strong unique key from a password generator, matters just as much here as anywhere else, a point I keep coming back to in the developer productivity guide.
Why does a WiFi QR code sometimes fail to connect?
When a code does not work, the cause is almost always one of a short list. The SSID or password was mistyped, so the credentials simply do not match the network. The security type is wrong, for example set to WEP when the network is actually WPA2. The network is hidden but the hidden flag was not set, so the phone never probes for it. Or the printed code has poor contrast, is too small, or lacks a quiet zone, so the camera cannot resolve it.
Work through them in that order. Regenerate with the exact credentials, double-checking case. Confirm the security mode on the router. Enable the hidden option if the SSID is not broadcast. And for print problems, keep the dark modules genuinely dark on a light background, leave at least a four-module white margin around the code, and test at the real printed size rather than on screen. One more subtle point: some older Android phones do not read WiFi codes from the plain camera app and need the scanner built into WiFi settings instead, so if one phone struggles, try another before assuming the code is broken.
How does this compare to a vCard or plain QR code?
A WiFi code and a vCard QR code are cousins. Both encode a specific structured payload that phones understand natively, and both are static and private. The difference is the action they trigger: a WiFi code offers to join a network, while a vCard code offers to save a contact. If you find yourself wanting to share more than just WiFi, for instance a business that wants guests to save its details too, the vCard tool is the companion piece.
For anything that is not one of these recognised formats, the general QR code generator handles plain URLs, text, email, SMS, and phone numbers. The dedicated WiFi tool exists because network credentials have enough of their own rules, escaping, security types, hidden flags, that a focused interface is faster and harder to get wrong than a general one. You do not have to think about the payload format; you fill in the fields you already know and the correct string is built for you.
Frequently asked questions
What is a WiFi QR code?
A WiFi QR code is a QR code that stores a network name, password, and security type in the standard WIFI: format. When a phone camera scans it, the device offers to join that network automatically, so nobody has to read or type the password.
How do I create a QR code for my WiFi?
Enter your network name (SSID), the WiFi password, and the security type, which is WPA/WPA2/WPA3 for most routers. The tool builds the WIFI: payload and encodes it as a scannable QR code you can download as SVG or PNG and print.
How do guests connect using the WiFi QR code?
On iPhone and most Android phones, open the camera app and point it at the code. A banner appears offering to join the network; tap it and the phone connects. Some older Android devices need a dedicated QR scanner or the WiFi settings scanner instead of the camera app.
Is it safe to make a QR code for my WiFi password?
Yes, when you use a client-side tool like this one, because the password is encoded on your device and never uploaded. Remember, though, that anyone who can scan the printed code can read the network, which is exactly the point for guest WiFi but a reason to keep codes for private networks out of public view.
Which security type should I choose?
Pick WPA for any WPA, WPA2, or WPA3 network, which covers virtually every current router. Choose WEP only for old hardware that still uses it, and Open for a hotspot with no password. If you are unsure, your router label or admin page lists the security mode.
Does the WiFi QR code work for hidden networks?
Yes. Tick the hidden-network option and the payload includes the H:true flag, which tells the phone to actively probe for an SSID that is not broadcast. Without that flag, a phone may fail to join a hidden network even with the correct name and password.
Does the WiFi QR code expire or track scans?
No. It is a static QR code: the credentials are baked into the image, so there is no short link to expire and no dashboard counting scans. Free generators that require a signup often produce dynamic codes that route through their servers, but this one does not.
Why does my WiFi QR code fail to connect?
The usual causes are a mistyped SSID or password, the wrong security type, a missing hidden-network flag, or a low-contrast print that will not scan. Regenerate with the exact credentials, confirm the security mode on your router, and test the printed size before you make copies.
