What Is a WiFi QR Code?
A WiFi QR code is a standard QR code that encodes your wireless network credentials β the SSID (network name), password, and security protocol β in a machine-readable format. When a smartphone camera scans the code, the operating system automatically prompts the user to join the network without typing a single character. The connection happens in under two seconds.
WiFi QR codes use the MECARD-style WiFi URI format, which looks like this:
Each field in this string has a specific role: T: specifies the security type (WPA, WEP, or nopass for open networks), S: is the SSID, and P: is the password. The double semicolon ;; terminates the record. Hidden networks append H:true; before the terminator.
The MECARD WiFi Format β Technical Deep Dive
The WiFi URI scheme was standardized in collaboration with ZXing (the open-source QR barcode library), and is now recognized natively by Apple iOS, Android, and most QR scanner apps. The full specification supports the following fields:
| Field | Key | Required | Example |
|---|---|---|---|
| Security Type | T: | Yes | WPA, WEP, nopass |
| SSID | S: | Yes | CafeGuest2026 |
| Password | P: | For WPA/WEP | s3cur3P@ssw0rd |
| Hidden Network | H: | No | true or false |
Special characters in the SSID or password (such as ;, ,, ", and \) must be escaped with a backslash. For example, a password of pass;word must be encoded as pass\;word. Our generator handles all escaping automatically.
WPA3 vs WPA2 vs WEP β Security Protocols Explained
Understanding the security type you select is critical β not just for the QR code to work, but for the security of your network and its users.
WPA3 (Wi-Fi Protected Access 3)
WPA3 is the latest and most secure WiFi security standard, introduced by the Wi-Fi Alliance in 2018. It uses Simultaneous Authentication of Equals (SAE) β also called Dragonfly β to replace the older PSK (Pre-Shared Key) handshake. SAE provides forward secrecy, meaning that even if an attacker records encrypted traffic and later cracks the password, they cannot decrypt past sessions.
For WiFi QR codes, WPA3 networks use the same MECARD format with T:WPA β the device negotiates WPA3 automatically at the protocol level. WPA3 is natively supported on iOS 13+, Android 10+, Windows 10 version 1903+, and macOS Catalina (10.15)+. If your router supports WPA3 (or WPA2/WPA3 transition mode), always choose it over WPA2.
WPA2 (Wi-Fi Protected Access 2)
WPA2 uses AES-CCMP encryption and the PBKDF2 key derivation function. It remains the dominant standard and is supported on virtually all devices made since 2004. In the QR code format, WPA and WPA2 share the same T:WPA token β the distinction is handled at the protocol negotiation level between router and device. WPA2 is vulnerable to KRACK attacks and offline dictionary attacks against weak passwords, so always use a password of at least 16 characters combining uppercase, lowercase, numbers, and symbols.
WEP (Wired Equivalent Privacy)
WEP is a deprecated standard from 1997. It was cracked as early as 2001, and the IEEE deprecated it in 2004. Do not use WEP. Any modern attacker can break WEP encryption in under two minutes using freely available tools. If your router only supports WEP, replace it immediately. WEP is included in the WiFi QR code format for legacy compatibility only.
Open Networks (No Password)
Open networks use T:nopass in the MECARD format and have no password field. They are appropriate for public hotspots where encryption is handled at the application layer (HTTPS). For business deployments, never put sensitive internal traffic on an open network β use a dedicated guest SSID with a captive portal instead.
iOS and Android Compatibility β Version-by-Version Guide
iPhone (iOS/iPadOS)
- iOS 11β12: QR code scanning supported via Camera app, but WiFi auto-join requires explicit tap on the notification banner. The MECARD WiFi format is recognized but does not auto-connect β user must confirm.
- iOS 13β15: Full native WiFi QR code support. Camera app detects the QR code and shows a "Join Network" banner. One tap connects.
- iOS 16+ / iPadOS 16+: Improved detection speed and background processing. Supports WPA3 natively. Hidden networks prompt for SSID confirmation before joining.
- iPhone 14 and later: Enhanced QR scanning performance at distance and in low light due to improved camera ISP.
Android
- Android 9 (Pie) and earlier: No native WiFi QR code scanning in the Camera app. Requires a third-party app like Google Lens or ZXing Barcode Scanner.
- Android 10 (Q): First version with native WiFi QR code support in the Camera app. Also introduced the WiFi sharing feature that generates QR codes for saved networks.
- Android 11β12: Improved integration with network settings. Users can scan QR codes directly from the WiFi settings menu.
- Android 13+: QR code scanning integrated into the Quick Settings tile. One-swipe access from the notification shade. Full WPA3 SAE support.
- Google Pixel, Samsung Galaxy, OnePlus: All flagship Android OEMs support WiFi QR codes from their camera apps on Android 10+. Some Samsung devices added support in their Camera app on Android 9 via a software update.
β οΈ Compatibility Note
If your venue serves guests with older devices (Android 9 or iPhone running iOS 12), include a printed fallback with the WiFi password visible. You can also add a note: "Can't scan? Use Google Lens or any QR scanner app."
How to Create a WiFi QR Code β Step by Step
- Open the QR Generator: Navigate to our free QR code generator and select the WiFi type.
- Enter Your Network Name (SSID): Type the exact name of your WiFi network, including capitalization and spaces. The SSID is case-sensitive.
- Select Security Type: Choose WPA/WPA2 for most modern routers, WPA3 if supported, WEP for legacy devices only, or None for open networks.
- Enter Password: Type your WiFi password exactly as configured on the router. Remember special characters are auto-escaped by our tool.
- Hidden Network: Toggle on if your router does not broadcast the SSID. Users will be prompted to confirm the network name on their device.
- Customize: Add a logo, choose brand colors, and adjust the QR code style (dots, squares, rounded corners) to match your branding.
- Download: Export as PNG for digital use, SVG for scalable print, or PDF for immediate printing. Always choose at least 300 DPI for printed materials.
WiFi QR Code Use Cases β Business Deployment
π¨ Hotels and Hospitality
Hotels use WiFi QR codes on in-room key cards, welcome cards, and TV screen displays. Best practice: create a separate QR code for each floor or wing using a dedicated VLAN per area. This limits exposure if one QR code is photographed by an unauthorized person. Update QR codes monthly and post them behind the front desk as a reference.
Recommended size: 5 Γ 5 cm minimum for in-room table tent cards. For lobby displays (viewed from 1β2 meters), use at least 10 Γ 10 cm with a high error correction level (Level H) to handle any wear.
π½οΈ Restaurants and Cafes
Restaurants display WiFi QR codes on table tents, receipts, and chalkboard signs near the counter. A common approach is to laminate a table tent with both the WiFi QR code and the menu QR code side-by-side. This reduces the average wait time for WiFi connection from 3β4 minutes (password typing) to under 10 seconds.
For cafes with high-turnover customers, consider cycling the WiFi password weekly and regenerating the QR code. Our generator produces consistent codes immediately when details are updated β just reprint the updated version.
π’ Offices and Coworking Spaces
Offices typically maintain two networks: a secure internal network for employees and a guest network for visitors. The guest WiFi QR code should point only to the guest SSID, which should be isolated from internal systems with firewall rules. Display the QR code on meeting room screens, reception desks, and visitor badge lanyards.
π€ Events and Conferences
For conferences with 500+ attendees, print WiFi QR codes on conference badges, screen backgrounds, and session signage. Use the highest error correction level (Level H) for projected QR codes β ambient lighting changes and projector keystoning can distort the image. Test by scanning from the back row before the event begins.
QR Code Size and Placement Recommendations
The minimum size for a scannable QR code depends on the scanning distance and the printer resolution. Use this table as a guide:
| Scanning Distance | Minimum QR Size | Recommended Format | Error Correction |
|---|---|---|---|
| Hand-held (15β30 cm) | 2 Γ 2 cm | PNG 300 DPI | Level M |
| Table top (30β60 cm) | 5 Γ 5 cm | PNG 300 DPI or SVG | Level Q |
| Counter / wall (1β2 m) | 10 Γ 10 cm | SVG or PDF | Level H |
| Projected / screen (3β5 m) | 30 Γ 30 cm equiv. | SVG (vector) | Level H |
Always maintain a quiet zone (white border) of at least 4 modules around the QR code. Reducing or eliminating the quiet zone is the single most common cause of scan failures in printed materials.
Troubleshooting Common WiFi QR Code Scan Failures
QR Code Scans But Doesn't Connect
- Wrong password: Verify the password is identical to what is configured on the router, including capitalization and symbols.
- Wrong security type: Check your router admin panel. If the router uses WPA2-Enterprise (RADIUS), a standard WiFi QR code won't work β enterprise networks require certificate-based auth.
- Hidden SSID not toggled: If your network doesn't broadcast its SSID, ensure you checked the "Hidden Network" option when generating.
- Special characters not escaped: Passwords containing
;or"must be escaped. Use our generator to auto-handle escaping.
Camera Won't Recognize the QR Code
- Too small: Increase the QR code size. Minimum 5 Γ 5 cm for table-distance scanning.
- Low contrast: Dark QR code on a white background performs best. Avoid light-colored QR codes on dark backgrounds β most cameras struggle.
- Glare: Laminated surfaces cause glare in direct lighting. Use a matte laminate or reposition the printed card.
- Damaged or worn: If more than 30% of the QR code is obscured, even Level H error correction may fail. Replace worn codes promptly.
- Old Android device: Devices on Android 9 or below need a third-party scanner. Add a note directing users to Google Lens.
Network Connects But No Internet
This is a network configuration issue unrelated to the QR code itself. Common causes include: ISP outage, router DHCP pool exhausted (too many connected clients), bandwidth throttling on the guest SSID, or a misconfigured DNS server on the router. Verify internet access from another device that is already connected before troubleshooting the QR code.
Security Best Practices for WiFi QR Codes
- Use a dedicated guest SSID: Never share your primary network password via QR code. Create a separate guest VLAN that is isolated from your main network. This prevents guests from accessing file shares, smart home devices, or internal servers.
- Set a client isolation rule: Enable "AP Client Isolation" or "Wireless Client Isolation" on your router's guest network. This prevents guests from communicating directly with each other.
- Rotate passwords regularly: For high-traffic venues, change the guest WiFi password weekly or monthly. Update the QR code immediately after each rotation.
- Use strong passwords even for guest networks: A weak guest password is easily brute-forced. Use a 16+ character random password.
- Don't embed the password in the QR code label: Some businesses print the password text next to the QR code. This defeats the purpose β anyone who photographs the sign gets the password even without scanning.
π‘ Pro Tip: Dynamic QR Codes for Rotating Credentials
If you change your WiFi password frequently (a good security practice), consider using a dynamic QR code that redirects to a page with the current credentials. Update the destination URL each time you rotate the password β the physical QR code never changes, saving you from reprinting.
Frequently Asked Questions
Does a WiFi QR code expire?
No β the QR code itself does not expire. However, if your WiFi password changes, the old QR code will no longer work because it still encodes the previous password. Regenerate and reprint the QR code whenever credentials change.
Can someone steal my WiFi password from the QR code?
The WiFi credentials are stored unencrypted inside the QR code (the MECARD format is not encrypted). Anyone who scans the code can see the password by decoding it. This is why best practice is to use a dedicated guest SSID rather than your primary network, and to avoid printing the QR code alongside visible password text.
Does the QR code work without a password?
Yes. Open networks (no password) use the format WIFI:T:nopass;S:YourSSID;;. Any device that scans this code will be prompted to join the open network with a single tap.
Can I add a logo to my WiFi QR code?
Yes. Our generator supports embedding a logo in the center of the QR code. When adding a logo, always use at least Level Q or Level H error correction to ensure the code remains scannable despite the overlay. Keep the logo under 30% of the total QR code area.
What format should I use for printing: PNG or SVG?
SVG is strongly preferred for all print applications. SVG is a vector format that scales to any size β billboard to business card β without any loss of quality. PNG is raster-based and loses sharpness when scaled beyond its generation resolution. For digital displays (websites, screens), PNG at 2Γ the display resolution works fine. For anything printed, always use SVG or PDF.
No registration required. PNG, SVG, and PDF downloads. Instant generation.