QR Codes

How to Share Wi-Fi by QR Code and Fix Connection Errors

Create a guest Wi-Fi QR code with the right network name and security, understand password exposure, and diagnose scans that fail to connect a phone.

By the Criza Labs team · Updated · 6 min read

Key takeaways

  • Copy the network name and password exactly, and match the security setting to the router.
  • A Wi-Fi QR image contains usable credentials; share a guest network rather than private office access.
  • Generating a code does not test the router, and changing its password requires a replacement QR image.

A Wi-Fi QR code packages a network name, security type and password into a pattern that compatible phones can read. Use one for visitors at a home, café, clinic or small office when you want to avoid repeatedly spelling out credentials, while keeping control over which network guests receive.

Before you start

Find the network name, also called the SSID, and its current password in your router settings or another reliable record. Copy capitals, punctuation and spaces carefully. The Wi-Fi password is different from the password used to administer the router, and the generator needs only the network credentials.

For a public counter or waiting room, set up a guest network if your router provides one and check its access settings. Give visitors that network’s credentials rather than those used by your own work devices. A QR image is a convenient way to distribute access, so choose where to display it with the same care you would use when displaying the written password.

Inputs and logo files stay in your browser during generation; CrizaTools does not upload them. That privacy does not hide the password inside the finished QR image: someone who obtains it can decode its contents. Use a trusted device, keep the download in an appropriate place and replace displayed copies when the guest credentials change.

Step by step with CrizaTools

  1. Open the Wi-Fi QR code generator. Wi-Fi should be the selected content type. If you have switched types, select Wi-Fi again before entering credentials.
  2. Enter Network name (SSID) exactly as configured. Do not substitute the name of your café or office unless that is also the actual wireless network name.
  3. Choose Security. The available options are WPA or WPA2 or WPA3, WEP (old) and No password. Match the router’s configuration; the generator does not detect it for you.
  4. Enter Password for a protected network. The field displays text so you can check it, and the tool asks for a password if the selected security requires one. Choose No password only for a network configured that way.
  5. Tick This network is hidden only when the router actually hides that SSID. Leave it unticked for an ordinarily visible guest network. The preview updates as you enter usable details.
  6. Choose a simple design and, if helpful, a Frame with Frame text such as Guest Wi-Fi. Preserve the blank border around the pattern. A logo is optional and should not make scanning harder.
  7. Choose Download size and select PNG, JPG or SVG. Scan the downloaded code with a phone, accept the connection prompt if offered, and verify that the phone joins the intended network. Test the printed copy too.

Two worked examples

Example 1: a café guest network. Suppose the router is configured with network name PuneCafeGuest, password ChaiTime!26, and personal WPA2 security. Choose WPA or WPA2 or WPA3 and leave the hidden-network box unticked. The exact text encoded by CrizaTools is:

WIFI:T:WPA;S:PuneCafeGuest;P:ChaiTime!26;;

The S field contains the SSID and P contains the password. A compatible scanner can use this payload to offer connection, but the example credentials alone cannot create a network or validate your router. For a real café, use its actual guest network and test with a phone that is not simply reconnecting from previously saved credentials.

Example 2: punctuation in a hidden network. Suppose your router uses SSID Clinic;Guest, password Tea:2026!, WPA2 personal security, and a hidden SSID. Enter those characters normally, without adding backslashes, and tick This network is hidden. The exact encoded result is:

WIFI:T:WPA;S:Clinic\;Guest;P:Tea\:2026!;H:true;;

The generator adds the escape characters needed for punctuation in this format; they are not extra characters in the actual network name or password. The hidden flag is H:true. These fields follow the Wi-Fi payload conventions documented by ZXing, checked 16 November 2026. If the phone still cannot join, compare the unescaped credentials against the router before changing the QR design.

Limits and what to watch for

Generating a Wi-Fi QR image does not change the router or check that its password works. If scanning recovers the right credentials but connection fails, try entering those same credentials manually. A manual failure points you toward the network configuration or coverage; a successful manual connection helps isolate a scanner or payload compatibility problem.

The three security choices cover the credential fields shown in this tool. There are no username, identity or certificate controls for enterprise authentication, and a code cannot complete a separate captive-portal sign-in. Compatibility varies by phone and scanner, so test the devices your visitors use rather than assuming every camera handles every network configuration.

Changing the SSID, password or relevant security configuration requires a new QR image. Removing an old poster does not erase saved credentials from guests’ devices; manage access through the router when necessary. After replacing credentials, remove stale copies from printed cards and shared messages as well.

Network name and password fields each allow up to 300 characters in this interface, which is not a claim that every router accepts that length. Optional logos accept PNG, JPG, WebP or SVG up to 10 MB, using 1,048,576 bytes per MB; large logos are scaled down safely to a 360-pixel long edge for embedding. Export sizes run from 512 to 4096 px, while caption frames can make the exported image taller than its width.

Common mistakes

  • Entering a router administration password: use the password that a phone needs to join Wi-Fi.
  • Adding spaces while copying credentials: compare every character with the router’s network settings.
  • Selecting No password to hide a missing password error: match the network’s actual security configuration.
  • Typing escape backslashes yourself: enter the original SSID and password; the generator handles encoding.
  • Testing on a phone already connected: test a fresh connection so saved details do not hide a mistake.
  • Keeping an old QR after a password change: generate, test and distribute a replacement image.

Questions and answers

Can someone see my password from a Wi-Fi QR code?

Yes, the finished image contains the credentials needed to describe the network connection. Browser-only generation keeps them from being uploaded to CrizaTools, but anyone with the image may be able to decode them.

Why does my Wi-Fi QR code scan but fail to connect?

The decoded SSID, password or security type may not match the router, or the network may be unavailable to that device. Test the same credentials manually and check whether a captive portal or enterprise login requires additional steps the code cannot supply.

Do I need to escape semicolons in my Wi-Fi password?

Enter the actual password as it is, including any semicolon. CrizaTools adds the necessary escaping to the encoded payload, so adding your own backslashes would change the password being described.

Does a Wi-Fi QR code work after I change the password?

An existing image continues to contain the old password. Generate a new image with the updated credentials, test a fresh connection and replace the old displayed and shared copies.

Can I make a QR code for a hidden Wi-Fi network?

Select This network is hidden when entering the network details. The payload includes the hidden-network flag, but you should still test it on the intended phones because scanner support and network configurations differ.

Sources

Prepare your guest access card with the Wi-Fi QR code generator, then verify its decoded contents with the QR code scanner.

Free tools for this

QR codes

QR Code Scanner

Scan a QR code with your phone or laptop camera, or from a screenshot or photo.

PDF & image

Password Generator

Generate strong random passwords up to 64 characters with letters, numbers and symbols, using your browser's secure random generator.

More guides

Free desktop app from Criza Labs

Bill every day? Get CrizaVoise free

GST invoices, thermal receipts, stock and payments in one offline app for Windows, Linux and macOS. No subscription, no sign-up, no ads, and your data stays on your computer.

  • 58 mm and 80 mm thermal printing
  • UPI QR on every invoice, WhatsApp sharing
  • Open source (Apache 2.0), English, Hindi, Gujarati and more
The CrizaVoise dashboard with quick bill and new invoice buttons, stock alerts and sample figures