How a WiFi QR code works
A WiFi QR code contains connection details as text, not a web link. A compatible camera reads the network name, security type, password, and optional hidden-network flag, then offers to join the network. The phone still authenticates with the router; scanning alone does not bypass its security.
The ZXing WiFi format uses fields such as T for security, S for the exact SSID, P for the password, and H:true for a hidden network. For example:
WIFI:T:WPA;S:GuestNetwork;P:ExamplePass123;; Open networks use T:nopass and omit the password. A hidden SSID needs its exact name plus H:true. Characters such as semicolons and backslashes must be escaped when creating the payload; this tool handles that automatically. QR codes do not configure enterprise 802.1X credentials or skip a captive portal.
Device compatibility quick reference
These are supported paths to try, not a guarantee for every camera app, router, or security mode.
- iPhone and iPad: Scan with Camera or the Control Center Code Scanner, then follow the join prompt. See Apple's scanning instructions.
- Pixel and other Android phones: Try Camera, Google Lens, or the Quick Settings QR scanner tile. Menu names and Wi-Fi sharing steps vary by manufacturer.
- Laptops and older phones: Provide the SSID and password as readable text on the sign for manual entry.
After scanning, the code may be readable even when the device cannot join the network. Check security mode, the exact password, range, and captive portal requirements.
Scanning on Apple iPhone & iPad (iOS 11+)
- Open the native Camera app: Swipe left on your Lock Screen or tap the Camera icon on your Home Screen.
- Point the rear camera steadily: Center the WiFi QR code in the frame. Do not press the shutter button.
- Look for the yellow notification: A yellow pill shaped banner reading
Join "[Network Name]" Networkwill pop up over the code. - Tap Join: Tap the banner, then tap Join in the system dialog. Your iPhone connects to the network.
Scanning on Android (Samsung, Pixel, Motorola)
Android devices running Android 10 or later feature multiple built-in scanning options:
Method A: Quick Settings Tile
Swipe down from the top of your screen to open Quick Settings. Tap Scan QR code (or 'QR code scanner'). Center the camera over the code and tap Connect to Network.
Method B: Camera / Google Lens
Open the standard Camera app or tap the Lens icon in the Google search bar. Aim at the code and tap the network badge that pops up on screen.
What happens after scanning?
iPhone and Android show a network prompt before joining. If the code is recognized but connection fails, check the exact SSID and password, router range, and whether the router supports the phone's security mode. WPA3-only, WEP, and hidden networks can behave differently across devices. A captive portal may open only after WiFi connection; the QR code does not complete its web sign-in.
On Android, the system QR scanner or Google Lens may work when a manufacturer's Camera app does not. On iPhone, check that QR scanning is enabled in Camera settings. If a laptop or older device cannot scan, provide the network details for manual entry. For hospitality and guest networks, consider creating formatted tabletop signs with our Printable WiFi Sign Maker, and learn best practices for network isolation in our guide on WiFi QR code safety. Have questions? Reach out via our contact page.
Troubleshooting: Why Isn't the Code Scanning?
1. Clean the Camera Lens
Fingerprint smudges on mobile lenses scatter light and blur barcode edges. Wipe your lens with a soft microfiber cloth or shirt.
2. Adjust Distance
Holding the phone too close (under 4 inches) prevents optical focus. Back up to 8–12 inches so the camera sensor snaps sharp focus.
3. Eliminate Glare & Reflections
If the QR code is inside a glossy photo frame or plastic table stand, tilt your phone slightly to dodge ceiling light glare.
4. Ensure Adequate Lighting
In dim restaurants or bedrooms, turn on your smartphone flashlight or use the built-in torch button inside the Quick Settings scanner.
Ready to Create Your WiFi QR Code?
Generate a private, client-side QR code or printable sign for your home, cafe, or office.