
A WiFi QR code lets guests join your network by scanning a small code with their phone camera — no typing a long password, no asking at the front desk. You encode your network name and password into the code once, print it on a card or sticker, and anyone who scans it connects in seconds. This guide shows you how to create one, when to use a dynamic code instead so you can change the password or track scans without reprinting, and where to place it for the most connections.
Key takeaways
- A WiFi QR code stores your network name, password, and security type so guests connect with one scan — no manual entry.
- Most phones connect straight from the camera; older devices may need a free QR reader.
- A direct WiFi code is static, so if you rotate passwords often, a dynamic code pointing to a WiFi landing page is easier to maintain.
- Dynamic codes also let you see how many guests connect and update details without reprinting a single card.
- Print it at a scannable size with a quiet zone and a short prompt like “Scan to connect to WiFi.”
What is a WiFi QR code?
A WiFi QR code is a code that contains your wireless network credentials — the network name (SSID), the password, and the encryption type (usually WPA/WPA2). When a guest scans it, their phone reads those details and offers to join the network automatically, so they never see or type the password. It turns "what's the WiFi password?" into a single scan, which is why cafés, hotels, salons, and offices print them on table cards, room signage, and reception desks.
What is actually inside a WiFi QR code?
Unlike a link, a WiFi code contains no address at all. It holds a short structured string that phones know how to interpret, and it looks like this:
WIFI:T:WPA;S:Guest-Network;P:hunter2;;
Four fields do the work. T is the authentication type — WPA, WEP, or nopass for an open network. S is the network name. P is the password, ignored when the type is nopass. An optional H field marks a hidden network. The double semicolon at the end terminates the record (ZXing, barcode contents specification).
The structure explains a failure that otherwise looks like magic. Because semicolons and colons separate the fields, a password containing one of those characters has to be escaped with a backslash — the specification lists \, ;, ,, " and : as characters requiring it. A generator that skips this step will produce a code that scans perfectly and then fails to join, because the phone read half your password as the start of the next field. If your WiFi password contains punctuation and a code refuses to connect, this is almost always why.
How do you create a WiFi QR code, step by step?
You can generate a working WiFi QR code in just a few minutes. Here's the process from start to finish:
- Gather your network details. You need the exact network name (SSID), the password, and the security type (WPA/WPA2 for most modern routers).
- Choose static or dynamic. A static WiFi code encodes the password directly. A dynamic code points to a short link you control — better if you change the password or want analytics.
- Generate the code. Enter your details in a QR platform, then style it with your logo, brand colors, and a frame.
- Test on real phones. Scan with both an iPhone and an Android device and confirm each one connects without errors.
- Print and display. Add a clear prompt such as “Scan to connect” and place the code where guests sit or wait.
- Update when needed. With a dynamic code, change the destination if your password rotates — the printed code keeps working.
Should you use a static or dynamic WiFi QR code?
It depends on how often your details change and whether you want data. A static code is fine for a home or a network with a fixed password. A dynamic code makes more sense for any business that rotates credentials, runs multiple locations, or wants to measure usage. If you're new to the difference, our guide to the dynamic QR code explains how editable, trackable codes work.
| Factor | Static WiFi code | Dynamic WiFi code |
|---|---|---|
| Password changes | Requires a brand-new code | Edit the destination, same code |
| Scan analytics | None | See connections and peak times |
| Branding & landing page | Credentials only | Branded WiFi welcome page |
| Best for | Home, fixed password | Cafés, hotels, offices, events |
Why do hotels and cafés put WiFi codes on a landing page?
Because a dynamic code that opens a short WiFi welcome page gives a business control and insight that a raw credential code can't. The page can show the password, a one-tap connect button, your logo, and even a link to today's menu or a promotion. Because the printed code points to a link you own, you can rotate the password, swap the offer, or redirect guests at any time without reprinting. For hospitality venues that already use scannable codes — like a QR code menu — adding a WiFi code keeps the whole guest experience contactless and on-brand.
Will a WiFi QR code work on every phone?
Most phones from the last several years connect directly from the built-in camera app — guests simply point and tap the prompt. Some older Android devices need a free QR reader or the camera's QR mode enabled, and a few locked-down work phones block automatic joins. To avoid confusion, it helps to print the network name and password in small text beneath the code as a fallback, so anyone can still connect manually.
Why does a WiFi QR code sometimes fail to connect?
The code scans, the phone shows a prompt, and then nothing. Five causes account for nearly all of it, in rough order of how often they occur.
- The network name is wrong. Not misspelled in an obvious way — wrong in case. SSIDs are case-sensitive, so
Cafe-Guestandcafe-guestare different networks as far as the phone is concerned. - Punctuation in the password was not escaped. See above. Test with the actual password, not a placeholder.
- The network is hidden. Some phones refuse to join a hidden SSID from a code even when the
Hfield is set correctly. If you broadcast nothing, expect a portion of guests to fail. - The router uses WPA3 only. The format predates WPA3 and encodes it as
WPA; most modern devices cope, older ones do not. A network set to WPA2/WPA3 mixed mode has far fewer problems than WPA3-only. - The guest network requires a captive portal. The code joins the radio network successfully, but the guest still has to accept terms in a browser. That is not a failure of the code — but if nobody tells them, it looks like one.
Test every code on both an iPhone and an Android device before printing. The two platforms handle edge cases differently often enough that passing on one proves very little about the other.
Where should you place your WiFi code for the most scans?
- At eye level where guests settle. Table tents, the corner of each table, or a bedside card in a hotel room earn the most scans.
- At the point of waiting. Reception desks, waiting rooms, and queue areas are prime spots — people reach for their phones there.
- Size it correctly. Follow the 10:1 rule: the code should be at least a tenth as wide as the scanning distance. For a table card scanned from ~30 cm, about 3 cm works.
- Keep a quiet zone and high contrast. Leave clear space around the code and use a dark code on a light background so cameras lock on fast.
- Add a short call to action. “Scan to connect to WiFi” performs better than a bare code.
Is it safe to share WiFi through a QR code?
Sharing WiFi by code is as safe as sharing the password any other way — the code simply carries the same credentials. For businesses, the more secure approach is a separate guest network kept apart from your internal systems, so visitors get internet access without touching staff devices or sensitive data. A dynamic code adds another layer of control: if you ever need to cut off access, you rotate the guest password and update the code's destination, and the old credentials stop working.
Two numbers from the barcode standard decide whether a card on a table reads on the first try. The quiet zone — the blank margin around the pattern — must be at least four times the module width on all four sides; a decorative frame pressed against the code breaks scanning long before size becomes the issue. And error correction is a trade rather than a free upgrade: the four levels recover roughly 7%, 15%, 25% and 30% of a damaged code, but each step up consumes capacity that would otherwise hold your network name and password (GS1, 2D barcodes at retail point-of-sale). A long password already pushes the code denser, so on a small card the higher correction levels can work against you.
Frequently asked questions
Can I make a WiFi QR code for free?
Yes — generating a basic static WiFi code is typically free. You only need an account with a QR platform if you want a dynamic code, branding, or scan analytics.
What happens if I change my WiFi password?
A static code stops working and must be regenerated and reprinted. A dynamic code keeps working: you just update the credentials behind it, so the printed code stays valid.
Do guests need an app to scan the code?
Usually not. Most modern iPhones and Android phones connect straight from the camera app. Only some older devices need a free QR reader or the camera's QR setting turned on.
Why does my WiFi QR code scan but not connect?
Almost always one of three things: the network name differs in capitalisation, the password contains a character such as a semicolon or colon that was not escaped when the code was generated, or the network is hidden. Test with the real credentials on both an iPhone and an Android phone before you print anything.
Can I use a WiFi QR code for a network with a captive portal?
Yes, and the code will join the network correctly — but the guest still has to open a browser and accept the terms before traffic flows. Print a line of text saying so next to the code. Without it, guests conclude the code is broken and ask staff, which is the friction you were trying to remove.
Does the code stop working if I change the WiFi password?
Yes, immediately. The password is inside the code, so a rotation invalidates every printed copy at once. If you change passwords on a schedule, plan the reprint into the same routine — or point the code at a short landing page that displays the current credentials, which keeps one printed code valid across rotations.
Create your guest WiFi QR code with QRiety
QRiety lets you create a dynamic WiFi QR code, brand it with your logo and colors, and update the network details anytime without reprinting — plus real-time analytics so you can see how many guests connect. Start free and set up your guest WiFi QR code in minutes.


