How to Make a Wi-Fi QR Code: Complete Step-by-Step Guide
Learn how Wi-Fi QR codes work, what goes inside one, how to create one for your home, office or rental, how to handle special characters and hidden networks, and how to print and place it so guests can connect in seconds.
Reading out a Wi-Fi password like "Xk9#pL2-mQ" to a guest, letter by letter, is nobody's favorite activity. A Wi-Fi QR code solves it: the guest points their phone camera at the code, taps a prompt, and they're connected. No typing, no spelling, no confusion between a zero and a capital O.
This guide explains exactly what a Wi-Fi QR code contains, how to create one correctly, the mistakes that stop codes from working, and how to print and place them. If you just want to make one now, use QR Helper's free Wi-Fi QR code generator, which builds the code in your browser without sending your password to a server.
What a Wi-Fi QR Code Actually Contains
A Wi-Fi QR code doesn't contain a link. It contains a short piece of structured text that phones recognize as network settings. The widely used format, which originated in the open-source ZXing barcode project and is now understood by the camera apps on modern iPhones and Android phones, looks like this:
WIFI:T:WPA;S:CoffeeShopGuest;P:latte-art-2024;H:false;;
Each part is a field:
- WIFI: tells the phone this is a network configuration.
- T: the security type. Common values are
WPA(used for WPA and WPA2 personal networks, and usually for WPA3 personal as well),WEPfor very old networks, andnopassfor open networks with no password. - S: the SSID, which is the network name exactly as it appears in your Wi-Fi list.
- P: the password. Leave it out for open networks.
- H: whether the network is hidden. Use
trueonly if your router doesn't broadcast its name. You can usually omit this field. - ;; ends the code.
Because the password is stored in the code as plain text, anyone who scans the code, or photographs it and decodes it later, can read the password. That's fine for a guest network; think twice before posting your main network's code somewhere public. Our Wi-Fi QR code security guide covers this in depth.
Before You Start: Collect the Right Details
Most Wi-Fi QR code failures come from wrong details, not from the code itself. Gather these first.
1. The exact network name (SSID)
Check it on a device that's already connected, or in your router's admin page. Network names are case-sensitive and spaces count. "Home WiFi" and "Home Wifi" are different networks to a phone.
If your router broadcasts separate names for 2.4 GHz and 5 GHz bands (for example "HomeNet" and "HomeNet-5G"), decide which one guests should join. The 2.4 GHz band generally reaches further and works with older devices; the 5 GHz band is usually faster at close range. Some routers use a single name for both bands and steer devices automatically, in which case you only need one code.
2. The exact password
Also case-sensitive. If you're unsure, log in to your router's admin page or check the label on the router if you never changed the default. On a phone that's already connected, you can often view it: on recent versions of iOS, open Settings, then Wi-Fi, tap the info button next to the network and tap the password field (Face ID or passcode required). On many Android phones, open the network in Wi-Fi settings and tap "Share," which shows the password and a QR code.
3. The security type
Most home and small business networks use WPA2 or WPA3 personal, so choose WPA. Only choose WEP if your router explicitly uses it (and consider upgrading, since WEP is long obsolete and insecure). Choose "no password" only for genuinely open networks.
4. Whether the network is hidden
If you have to type the network name manually to connect, it's hidden. Otherwise it isn't.
Step-by-Step: Create the Code
Using QR Helper's Wi-Fi QR code generator:
- Enter the network name exactly as it appears.
- Enter the password exactly, paying attention to capitals, numbers and symbols.
- Choose the security type: WPA/WPA2/WPA3 for nearly all modern networks.
- Tick "hidden" only if your network is hidden.
- Generate the code and download it as an image.
- Test it with at least two different phones, ideally one iPhone and one Android, before printing. Turn off Wi-Fi or "forget" the network on the test phone first, so you know the code is doing the work.
The generator encodes everything locally in your browser. Your network name and password are not uploaded or stored.
Special Characters in Passwords and Network Names
The Wi-Fi format uses certain characters as separators. If your network name or password contains them, they must be "escaped" with a backslash so phones read them correctly:
- semicolon
; - colon
: - comma
, - backslash
\ - double quote
"
For example, a password of pass;word must be written inside the code as pass\;word. A good generator does this for you automatically. If you're writing the text by hand or using a generic text-to-QR tool, you'll need to escape these characters yourself, and forgetting to is one of the most common reasons a code "almost works": the phone sees the network but the password is rejected.
Spaces don't need escaping. Emoji and non-English characters in network names are generally supported by modern phones, but they're a common source of trouble with older devices, so test carefully.
How Guests Use It
iPhone and iPad
Since iOS 11, the built-in Camera app recognizes Wi-Fi QR codes. The guest opens the Camera, points it at the code, and taps the "Join network" notification that appears. The Code Scanner in Control Center works too.
Android
On Android 10 and later, the camera app on most phones recognizes Wi-Fi codes, and Wi-Fi settings typically include a QR scanner icon next to "Add network." Google Lens can also read them. Exact menus vary by manufacturer, so if the camera doesn't react, try the scanner icon in Wi-Fi settings.
Laptops and other devices
Laptops usually don't have a convenient QR camera workflow, so it helps to print the network name and password in plain text next to the code. That also helps guests whose phones can't scan for any reason.
Designing and Printing the Code
Size
For a code read from arm's length, around 2 to 3 cm (roughly 1 inch) is the practical minimum; 5 cm (2 inches) or larger is more comfortable, especially in dim rooms. For codes viewed from a distance, such as on a wall across a room, increase the size accordingly. A common rule of thumb is that the scanning distance can be about ten times the code's width. See our QR code size guide for more detail.
Contrast
Dark code on a light background, with a clear margin (the "quiet zone") of blank space around all four sides. Avoid light-on-dark inverted codes and low-contrast colors; some phones handle them, many don't.
Material and finish
Matte paper or a matte laminate scans more reliably than glossy surfaces, which reflect lights and windows. If you put the code in a frame, use non-glare glass or acrylic.
Add text
Good Wi-Fi signs include:
- A clear heading: "Free Wi-Fi: Scan to Connect."
- The network name and password in readable text, for laptops and older phones.
- Brief instructions: "Open your camera and point it at the code."
Where to Put It
- Homes: in the entry hallway, guest room or on the fridge. Inside a kitchen cabinet door is a good spot if you'd rather it not be visible to every visitor.
- Vacation rentals: by the entrance and in the welcome book. Our Airbnb host QR code checklist covers other codes rentals benefit from.
- Cafés and restaurants: on table tents, at the counter or on receipts. Rotate the guest password periodically and reprint.
- Offices: in reception and meeting rooms, for the guest network only.
- Events: on badges, signage or the printed program.
When You Change the Password
A Wi-Fi QR code contains the password itself, so changing your password makes old codes stop working. You'll need to generate and print a new code. This is normal and unavoidable: a Wi-Fi code can't be "dynamic" in the way a link code can, because the phone reads the network settings directly from the image rather than visiting a website.
To make this easier, keep the digital file and a note of where every printed copy is. If you rotate a guest password regularly, design your sign so the code is easy to replace, for instance a slot-in card in a stand.
Common Mistakes
- Wrong capitalization in the network name or password.
- Unescaped special characters, particularly semicolons and colons.
- Wrong security type, such as choosing WEP for a WPA2 network.
- Encoding the 5 GHz network in a place where guests' older devices only support 2.4 GHz.
- Printing too small or on glossy material.
- Not testing with a phone that isn't already connected.
If your code doesn't work, our Wi-Fi QR code troubleshooting guide walks through each failure and its fix.
Frequently Asked Questions
Do Wi-Fi QR codes expire? No. The code contains the network details directly and keeps working until you change the network name or password.
Do Wi-Fi QR codes need internet access to work? No. The phone reads the network settings from the image itself. No website is involved.
Can I see who scanned my Wi-Fi code? No. Because the code doesn't open a website, nothing records scans. Your router's admin page may show which devices are connected.
Can I make one for an enterprise (802.1X) network? The common format is designed for personal networks with a single shared password. Enterprise networks that need a username, certificate or individual credentials generally aren't supported by phone camera apps, so use your organization's onboarding process instead.
Is it safe? It's as safe as writing the password on a card, because effectively that is what it is. Use it for guest networks and keep your main network's password private. See our guide to Wi-Fi QR code security.
Ready to make one? Open the Wi-Fi QR code generator, enter your details and test it before you print.