QRFlow
Create
← All guides

WiFi QR Code: iPhone/Android format (works reliably)

Exact WIFI: payload format, what “Encryption” means, and how to avoid scan failures on iPhone/Android (special chars, hidden networks).

By QRFlowChecked against the current generatorPayloadsPrimary tool: WiFi
How we verify this guide

Before this page is included in the public guide directory, its examples are compared with the payload produced by the linked QRFlow generator and with the export and scan-readiness controls available in the current build. Camera, lighting, paper, print size, and destination apps can still change the result, so important print runs should always be tested on the final material and real devices.

On this page
  1. The format scanners expect
  2. Special characters that break scans
  3. Hidden networks
  4. Recommended workflow (fast)
  5. Reproduce an escaped WiFi payload
  6. When decoding succeeds but joining fails
Quick steps
  1. Open the WiFi template: Use the WiFi QR generator to start.
  2. Paste SSID and password: Copy the exact router values and avoid manual typing errors.
  3. Set encryption and hidden status: Use WPA for most networks; mark hidden networks correctly.
  4. Handle special characters: If SSID or password includes ; , : or \, keep them exact.
  5. Test on real phones: Scan on iPhone and Android before printing or sharing.

QRFlow generates WiFi QR codes locally in your browser (privacy-friendly; no uploads).

The format scanners expect#

Most iPhone/Android camera scanners understand this “WIFI:” payload (a de-facto standard):

WIFI:T:WPA;S:YourNetworkName;P:YourPassword;H:false;;
  • T: encryption type — use WPA for WPA/WPA2/WPA3, WEP for old routers, or nopass for open networks.
  • S: SSID (WiFi name)
  • P: password (omit if T:nopass)
  • H: hidden network (true/false)

Special characters that break scans#

If your SSID or password contains ; , : or \, some scanners fail unless the value is escaped. QRFlow handles this by escaping those characters in the WiFi payload.

If scans fail, compare the decoded payload with the exact router values (case-sensitive). Use fictional credentials for format tests; keep the real network password strong.

Hidden networks#

Hidden SSIDs are less reliable across devices. If you must use one, set Hidden network to true and keep the QR large enough for comfortable scanning.

  1. Open the WiFi template.
  2. Copy/paste SSID and password from the router settings (avoid manual typing).
  3. Test on at least one iPhone and one Android.
  4. Download SVG for print-ready signage (cafes, offices, event badges).

Reproduce an escaped WiFi payload#

Use this fictional example: network Cafe;Guest, WPA encryption, password demo:2026, and Hidden network off. Enter the values literally; do not add backslashes in the form. QRFlow adds the escaping when it builds the payload.

WIFI:T:WPA;S:Cafe\;Guest;P:demo\:2026;H:false;;

Export a PNG and read it with the local image scanner. Compare the decoded text with the example above. This checks encoding, not network connectivity: joining still requires a real router with matching credentials, compatible security settings, and a device in range. Decode the exported image

When decoding succeeds but joining fails#

  • No join prompt: the camera may treat the payload as text; try the phone’s WiFi settings scanner.
  • Wrong-password message: compare case, punctuation, and the network name with the router. Do not weaken a real network password to make the QR smaller.
  • Connected without internet: check the guest portal or router connection. A WiFi QR cannot complete a captive-portal login or configure an enterprise identity.

Format reference: ZXing WiFi payload conventions.

Recommended templates

WiFi QR Code
Create the WiFi QR and a print-sized guest card or fold tent locally, then scan-test the physical result on iPhone and Android.
URL QR Code
Convert a website link to a QR code instantly, then download a clean SVG or PNG.
Redirect QR Code
Create a redirect QR code for campaigns, menus, packaging, posters, and any QR that may need a controlled destination path.
Business Card QR Code
Create a vCard QR and complete front/back business card artwork with real trim, bleed, safe-area, and print checks before ordering cards.
YouTube QR Code
Turn the right YouTube destination into a QR code, then check the scan flow before using it on posters, packaging, slides, or merch.
Instagram QR Code
Create an Instagram profile QR on desktop/web and download PNG or SVG for cards, packaging, posters, creator kits, or quick sharing.

Use cases & print ideas

Matching pages that explain where this QR type works best before you open the generator.
WiFi QR Code Use Cases
Let guests connect by scanning once instead of typing a long password at reception desks, rentals, cafes, or events.
Redirect QR Code Use Cases
Use Redirect QR for a controlled destination path; only hosted dynamic QR lets the printed asset stay fixed while the destination changes after launch.
YouTube QR Code Ideas for Print and Promotion
Turn offline scans into video views, channel subscriptions, or playlist opens without asking people to type a URL or search your handle.
Instagram QR Code PNG Ideas for Print and Packaging
Use an Instagram profile QR when you need a desktop-ready PNG or SVG for cards, packaging, posters, creator kits, or retail surfaces.

Continue reading

Next →
Best QR Code Size for Business Cards: 20-25 mm (0.8-1.0 in)
Use 20-25 mm (0.8-1.0 in) for most business cards. Includes minimum size guidance for short URLs, larger sizing for vCards, quiet zone rules, and a card dimensions chart.

Related guides

Payloads
Which vCard fields actually get saved on iOS/Android, what to keep minimal, and how to avoid bloating the QR for better scans.
Use a Google Maps place link or directions link, then print a QR for storefronts, parking, pickup, invitations, and event wayfinding.
Use a bulk QR code generator to create many QR codes from CSV or a list. CSV format examples, file naming, and print tips.
Use 20-25 mm (0.8-1.0 in) for most business cards. Includes minimum size guidance for short URLs, larger sizing for vCards, quiet zone rules, and a card dimensions chart.
Create a Discord QR code for server invites, avoid expiring links, and share safely.
The real-world reasons QR codes fail (contrast, quiet zone, blur, density, glossy print) and the quickest fixes that work on iPhone/Android.

Quick answers

Common questions

What is the correct WiFi payload format?
Use WIFI:T:WPA;S:SSID;P:password;H:false;; with proper values.
Why does WiFi QR fail on iPhone?
Incorrect encryption or unescaped special characters often cause issues.
Try it now
Generate QR codes locally in your browser — no uploads.