Skip to content
ImageDoctor
Codes6 min read

How to make a Wi-Fi QR code that guests can scan to join

A Wi-Fi QR code holds your network name, security type and password. A phone that scans it offers to join, so nobody has to type a 20-character password off the back of a router.

Processed locally in your browser

A Wi-Fi QR code is a QR code that contains your network's name, its security type and its password, written in a standard format that phone cameras recognise. Scanning it offers to join the network, so nobody has to type the password. To make one, choose Wi-Fi in a QR code generator, enter the details exactly as your router has them, and test the code on a phone before you print it.

What is inside a Wi-Fi QR code?

Just a line of text. The format most scanners understand was popularised by the open-source ZXing barcode library, and it looks like this: WIFI:T:WPA;S:Guest Wi-Fi;P:welcome123;;. Each part is a letter, a colon and a value:

FieldMeansValues
TSecurity typeWPA for a password-protected network, WEP for legacy ones, or nopass for an open network
SNetwork name (SSID)Exactly as the router broadcasts it, including capitals and spaces
PPasswordLeft out for an open network
HHidden networktrue if the router doesn't broadcast its name

Because ;, :, ,, " and \ have a meaning in this format, they must be preceded by a backslash when they appear in a name or password (ZXing wiki, checked 4 November 2026). A network called Cafe;Guest with the password pa:ss1234 is written WIFI:T:WPA;S:Cafe\;Guest;P:pa\:ss1234;;. A good generator does this for you; a hand-made code that skips it is a common reason a code joins the wrong network name or fails outright.

How to make a Wi-Fi QR code

  1. Find the exact network name and passwordThey are usually on a label on the router, or in its admin page. On many Android phones you can also open Settings › Network & internet › Internet, tap the network you are connected to and tap Share, and the phone shows a ready-made code (Android Help, checked 4 November 2026; some of these steps need Android 12 or later).
  2. Open the QR Code Generator and choose Wi-FiIn the QR Code Generator, pick Wi-Fi as the content type and type the network name. It is checked as you go: names longer than 32 bytes are rejected, and a name that starts or ends with a space gets a warning, because the code has to match the router character for character.
  3. Pick the security typeChoose WPA / WPA2 / WPA3 (written into the code as T:WPA) for almost every home and office router, None for an open network, and WEP only for very old equipment. WPA passwords must be 8 to 63 characters (or a 64-digit hex key), and WEP keys 5 or 13 characters (or 10 or 26 hex digits); anything else is flagged before you download.
  4. Tick Hidden network if it is hiddenIf the router doesn't broadcast its name, the code needs to say so, or phones will look for a network they can't see.
  5. Download and test itUse SVG or PDF for print, since both stay sharp at any size, or PNG for a screen. Then scan it with two different phones before you print copies.

The code is generated in your browser; the network details are not uploaded to ImageDoctor. After each change the generator also decodes the code again on your device and compares it with what it should contain, which catches a styled design that has broken the symbol.

How do guests scan it?

Most current phones read QR codes from the ordinary camera app. On an iPhone, Apple's instructions are to open Camera in Photo mode, hold the code inside the frame and tap the prompt that appears at the bottom of the screen (Apple Support, checked 4 November 2026). Android phones offer the same through the camera or Google Lens, depending on the maker. The phone then asks whether to join the network.

Laptops usually can't scan a code, so print the network name and password as text next to it. That also helps anyone whose camera won't read the code.

Printing a Wi-Fi sign

For a café table, a holiday let or a meeting room, the QR Poster maker has a Wi-Fi access template that lays out a heading, the network name, the password and the code on one page, ready to print or frame. Two rules from our guide to QR codes that scan matter most here:

  • Size it for the distance. A useful rule is about one tenth of the scanning distance: 3 cm wide for a card read at 30 cm, 20 cm wide for a sign read from 2 m away.
  • Keep it plain. Dark modules on a light background, with an empty margin around the code. A logo is fine at error correction Q or H, but there is little reason to add one to a Wi-Fi sign.

Is it safe to put a Wi-Fi password in a QR code?

Treat the code exactly like the password written on paper, because that is what it is. The password is stored as plain text: any QR reader app shows it, and anyone who photographs the sign can read it later. Three habits keep that sensible:

  • Use a guest network for visitors if your router offers one, so the code never gives access to the computers and devices on your main network.
  • Change the password when you need to, then reprint. A Wi-Fi code is static: the old code simply stops working once the password changes, and there is no way to update a printed one.
  • Clear the generator's history on a shared computer. ImageDoctor keeps the codes you download or copy in a History list stored only in this browser, so you can reuse them. The Clear button empties it.

Why won't my Wi-Fi QR code connect?

SymptomLikely causeFix
Phone says it can't find the networkName doesn't match exactly, or the network is hiddenCopy the name from the router's settings; tick Hidden network if it is hidden
Phone finds it but the password failsPassword changed, or a typo in the codeCheck the password on a phone that joins by typing it, then remake the code
Older phones refuse to joinThe network uses WEPSwitch the router to WPA2 or WPA3; some phones no longer join WEP networks
It joins, then a login page appearsThe network has a sign-in portal (hotels, some offices)Expected: the code only gets the phone onto the network
Work network asks for a usernameWPA2-Enterprise (802.1X)Not covered by a simple Wi-Fi code; use your organisation's setup instructions

Common questions

No. The network details are inside the pattern, with no service in between, so the code keeps working until you change the network name, password or security type. Then you need a new code.

Yes. The password is stored as plain text, and any QR reader app will show it. Put the code where you would be happy to write the password itself, and use a guest network for visitors.

WPA / WPA2 / WPA3 for nearly every modern router. Choose None only for an open network, and WEP only for very old equipment that can't use anything else.

No. Everything the phone needs to join is in the code itself; reading it is done by the phone's camera software.

Tools in this article

All blog