WiFi QR Code Not Working? Common Problems and Fixes

A WiFi QR code should let guests connect to your wireless network in seconds. When it scans but does not connect — or does not scan at all — the cause is usually simple: an incorrect password, wrong network name, incorrect security type, a hidden-network setting, a low-quality printed code, or device compatibility issue.

This troubleshooting guide helps you identify the problem and fix it quickly. Whether you are setting up guest WiFi for a home, restaurant, office, hotel, Airbnb property, retail store, or event venue, use the steps below before creating and printing a replacement code.

Why Your WiFi QR Code May Not Be Working

A WiFi QR code stores your wireless network credentials, including the network name, password, and security type. A phone scans the code, reads those details, and attempts to join the network.

When the process fails, it usually falls into one of three categories:

1. The QR code cannot be scanned.
2. The QR code scans but the device cannot connect.
3. The device connects to WiFi but has no internet access.

Based on testing common WiFi QR code configurations, incorrect passwords, SSID mismatches, and wrong security-type selections cause many connection failures. The next most common issues are poor print quality, hidden networks, router restrictions, and device compatibility.

QR Code Scans But Doesn’t Connect

If the phone recognizes the QR code and shows the correct WiFi network name, the QR image itself is probably fine. The issue is more likely related to:

• Incorrect password
• Incorrect SSID
• Wrong security type
• Hidden network configuration
• Saved network conflict
• Router restrictions
• Guest network not functioning
• WPA3 compatibility issue

QR Code Won’t Scan

If the camera never detects the QR code, the problem is usually visual rather than network-related. Common causes include:

• QR code too small
• Blurry QR image
• Low-resolution file
• Missing white border
• Poor contrast
• Glossy print glare
• Cropped code
• Damaged printed material
• Large logo or excessive customization

Device Compatibility Issues

Most current iPhones and Android devices can scan WiFi QR codes. However, older devices, outdated operating systems, manufacturer-specific camera apps, and legacy WiFi security settings can affect compatibility.

Test the code on at least one iPhone and one Android device before using it publicly.

Check If Your WiFi Password Is Correct

The Most Common Cause

The most common reason a WiFi QR code scans but fails to connect is an incorrect password. A WiFi QR code stores the password exactly as it was entered. If one letter, symbol, number, or space is wrong, the phone cannot authenticate with the network.

Check the password in your router settings or internet-provider app, then compare it character by character with the password entered in the QR generator.

Password Case Sensitivity

WiFi passwords are case-sensitive. For example, `GuestWifi2026` is not the same as `guestwifi2026`. Likewise, `MyOfficeWiFi!` is different from `myofficewifi!`. A capital letter in the wrong place is enough to cause a connection failure.

Special Characters in Passwords

Passwords with special characters may cause mistakes when entered manually into a QR code generator. Check carefully for characters such as `; : , \ " ' ! @ # $ % & * ( ) _ -`. A semicolon or backslash may need special handling in the underlying WiFi QR format. Use a reliable WiFi QR code generator that handles formatting automatically, then test the final code on real devices.

If you changed the network password recently, the old WiFi QR code will no longer work. Generate a new one with the updated credentials.

Verify the Network Name (SSID)

Incorrect Network Name

The SSID is the exact name of your wireless network. It must match the router setting precisely. For example, `Cafe_Guest_WiFi` is different from `Cafe Guest WiFi` or `cafe_guest_wifi`. Check capitalization, spaces, underscores, hyphens, and special characters.

Hidden Spaces

Hidden spaces are easy to miss. A network name may accidentally include a space at the beginning, end, or between words. For example, `Office WiFi ` with a trailing space is different from `OfficeWiFi`. When entering an SSID into a WiFi QR code generator, copy it directly from the router or WiFi settings if possible.

Multiple Similar Networks

Many locations have similar network names, such as `Hotel_Guest`, `Hotel_Guest_5G`, `Hotel_Staff`, and `Hotel_Rooms`. Make sure the QR code points to the intended guest network. A QR code configured for the staff or 5 GHz network may not work for all guests.

Make Sure the Security Type Is Correct

The security type tells the phone how to authenticate with the wireless router. If it does not match your router configuration, the QR code may scan successfully but fail to connect.

WPA2

WPA2 is still widely used on home and business wireless networks. For many routers, selecting WPA or WPA2/WPA3 in a QR code generator will work correctly.

WPA3

WPA3 is a newer security standard with stronger protection. Newer phones and routers support it, but some older devices may not. If guests with older devices cannot connect to a WPA3-only network, consider using a mixed WPA2/WPA3 guest network if your router supports it.

WEP

WEP is an older security method and is no longer recommended. It is less secure and may not work reliably with newer devices. Use WEP only if your router is configured for it and cannot be upgraded. Whenever possible, move to WPA2 or WPA3.

Open Networks

An open network does not require a password. If you create a QR code for an open network, select the correct no-password or open-network option. Do not enter a password if the network is open. Incorrectly adding a password can prevent a device from connecting.

The QR Code Scans But Doesn’t Connect

Authentication Failed

An authentication error usually means the network password, SSID, or security type does not match the router settings. Start by checking:

• Network name is correct
• Password is correct
• Password capitalization is correct
• Security type is correct
• Hidden network option is correct
• Guest network is active

If all information looks correct, forget the network on the guest device and try scanning again.

Saved Network Conflicts

A phone may have an older saved version of the same network. This is common when a business or home has changed its WiFi password but kept the same SSID. On the device, go to WiFi settings, select the network, choose Forget This Network, and then scan the updated QR code again.

Router Configuration Problems

The router may be working but blocking new devices. Common causes include:

• Maximum connected-device limit reached
• Guest network disabled
• Router requires a captive portal login
• MAC address filtering enabled
• Network isolation settings misconfigured
• Router firmware issue
• Internet service outage

Test the WiFi manually with a known correct password. If manual connection also fails, the issue is with the router or internet connection, not the QR code.

WiFi QR Code Won’t Scan

Low Resolution QR Code

A low-resolution QR code can become unreadable, especially after printing or enlarging it. Use SVG format for print because it remains sharp at any size. Use high-resolution PNG for digital sharing. Do not print a small screenshot of a QR code. Generate and download the original high-quality file.

Blurry Image

Blur can occur when the QR code was photographed out of focus, copied from a small screenshot, compressed by a chat app, smudged on print, or displayed on a low-quality screen. Use the original QR code file whenever possible.

Poor Print Quality

Low ink, poor paper quality, weak contrast, low DPI printing, and damaged printer heads can make QR modules unclear. Print a test copy before producing menus, signage, hotel cards, brochures, posters, or table tents.

Small QR Code Size

For close-range scanning, use at least 1 × 1 inch (approximately 2.5 × 2.5 cm). Use larger codes for storefronts, posters, event signs, hotel welcome boards, and distance scanning.

Printed WiFi QR Code Not Working

QR Code Too Small

A QR code that looks acceptable on a computer screen may be too small when printed. This is especially common on receipts, labels, business cards, small stickers, and packaging. Increase the code size and leave enough blank space around it.

Low DPI Printing

Low DPI printing can blur the individual QR modules. Use vector SVG files for printed materials or high-resolution PNG files. For professional printing, avoid screenshots and images copied from messaging apps.

Glossy Surface Reflection

Glossy menus, laminated signs, plastic cards, glass, metal, and shiny packaging can reflect light into a phone camera. The glare may hide parts of the QR code. Try matte paper or a non-reflective display. If glossy materials are necessary, test the code under normal customer lighting.

Damaged Printed Codes

Outdoor signs, table cards, labels, and packaging can fade, scratch, fold, peel, or get dirty. Inspect printed codes regularly, especially in restaurants, hotels, retail stores, public areas, event venues, and outdoor locations.

WiFi QR Code Not Working on iPhone

iOS Compatibility

Most modern iPhones can scan WiFi QR codes using the Camera app or Apple Code Scanner. If an older iPhone cannot recognize the code, update iOS if possible.

Camera Issues

If the iPhone Camera app does not detect the code:

• Improve lighting
• Clean the camera lens
• Move closer or farther away
• Keep the full code visible
• Avoid glare
• Check that the code is not blurry or too small

WiFi Settings Problems

If the code scans but connection fails:

1. Open Settings > Wi-Fi.
2. Check whether the correct network appears.
3. Forget any older saved version of that network.
4. Scan the QR code again.
5. Confirm the password has not changed.

QR Detection Disabled

Check that QR scanning is enabled in Settings > Camera > Scan QR Codes. Turn it on, reopen Camera, and try again. For more iPhone-specific troubleshooting, see our guide on [How to Scan a QR Code on iPhone](/blog/how-to-scan-a-qr-code-on-iphone).

WiFi QR Code Not Working on Android

Android Version Compatibility

Most modern Android phones can scan WiFi QR codes through Camera, Google Lens, or WiFi settings. Older Android versions may need Google Lens or a dedicated QR scanner.

Samsung Devices

On Samsung Galaxy devices, scan a WiFi QR code using Camera, Samsung’s QR scanner, or WiFi settings. If the QR code scans but does not connect, check whether the network credentials are current and whether the device has an older saved version of the network.

Google Pixel Devices

Google Pixel phones commonly support WiFi QR scanning through Camera, Google Lens, and WiFi sharing settings. If the code is not detected, open Google Lens, select the QR image, and review the network details.

Camera Permissions

If you use a QR scanner app or browser-based webcam tool, confirm that camera access is allowed in Settings > Apps > [App Name] > Permissions > Camera. Allow camera access only for trusted apps.

Hidden WiFi Networks and QR Codes

What Is a Hidden Network?

A hidden WiFi network does not broadcast its SSID publicly. It will not appear in the normal list of nearby WiFi networks. Users must know the exact network name and password to connect.

Why Hidden Networks Cause Problems

A WiFi QR code may fail if the hidden-network setting is not selected correctly. The phone receives the SSID and password but may not know that it needs to search for a hidden network.

How to Configure Hidden Network QR Codes

When creating a WiFi QR code for a hidden network:

• Enter the exact SSID
• Enter the exact password
• Choose the correct security type
• Enable the hidden network option
• Test on both iPhone and Android
• Keep the guest network visible when possible for easier access

For most customer-facing locations, a visible guest network is simpler and more practical than a hidden network.

WPA3 Compatibility Issues

Older Phones and WPA3

WPA3 provides stronger security, but some older phones, tablets, laptops, and IoT devices may not support WPA3-only networks. If a newer phone connects but an older device does not, WPA3 compatibility may be the cause.

Mixed WPA2/WPA3 Networks

Many routers offer a mixed WPA2/WPA3 mode. This lets newer devices use WPA3 while allowing older devices to connect through WPA2. For guest WiFi in hotels, restaurants, offices, and event spaces, mixed mode can improve compatibility.

Router Settings

Open your router settings and check: security mode, WPA2/WPA3 compatibility mode, guest network status, SSID visibility, password accuracy, device connection limits, and firmware updates. Do not weaken security unnecessarily: use WPA2 or WPA3 instead of WEP whenever possible.

Router Problems That Affect WiFi QR Codes

Incorrect Router Configuration

A QR code can be correct while the router is misconfigured. Check whether the WiFi network works when guests enter the password manually. If manual connection fails, troubleshoot the router first.

Guest Network Restrictions

Some guest networks have restrictions that affect new devices. For example, the guest WiFi may be disabled, have a maximum device limit, require additional login, or block internet access after connection. Check your router’s guest network settings and make sure it is active.

MAC Address Filtering

MAC address filtering allows only approved devices to connect. If this feature is enabled, guests may see the network but fail to join even with the correct password. For public guest WiFi, MAC filtering is usually not practical unless you manage approved devices individually.

Network Isolation Settings

Guest networks often isolate devices from each other for security. This is generally a good feature. However, isolation settings can sometimes prevent access to local resources such as printers, media servers, or local business systems. For guests who only need internet access, device isolation is usually appropriate.

How to Test Your WiFi QR Code

Test on Multiple Devices

Test the code on an iPhone, an Android phone, a tablet if relevant, and a device that has never joined the network before. This helps identify compatibility issues before guests encounter them.

Test With Different Cameras

Try scanning using iPhone Camera, Apple Code Scanner, Android Camera, Google Lens, and a trusted QR scanner. If only one scanner fails, the code may be too dense, too customized, or difficult for that camera system.

Verify Password Accuracy

Before printing, manually connect a phone to the network using the same SSID and password used in the QR code. This confirms the credentials are correct.

Test Before Printing

Test the final QR code design — not only the generator preview. If the code will be printed on a glossy menu, table tent, hotel card, poster, sign, or receipt, test a printed proof under real lighting conditions.

Quick WiFi QR Code Troubleshooting Checklist

Before recreating your WiFi QR code, confirm:

• SSID matches the router exactly
• Password matches the current network password
• Capitalization and special characters are correct
• Correct security type is selected
• Hidden-network setting is correct
• Guest network is active
• Router is functioning normally
• QR code is high resolution
• QR code is large enough to scan
• White border around code is visible
• Code is tested on iPhone and Android
• Printed version is tested before public use

How to Create a Reliable WiFi QR Code

Use Accurate Network Details

Copy the SSID and password directly from router settings whenever possible. Do not rely on memory, handwritten notes, or old passwords.

Double-Check Security Settings

Most modern networks use WPA2 or WPA3. Select the security option that matches your router. If you are unsure, check router settings or ask the person who manages the network.

Generate High-Resolution QR Codes

Use SVG for signs, posters, menus, hotel cards, and other print materials. Use high-resolution PNG for digital use. Avoid tiny screenshots or compressed images.

Test Before Sharing

Scan the code with multiple devices before placing it in public locations. This is especially important for restaurant WiFi, hotel rooms, office guest networks, Airbnb check-in guides, and event venues.

Common Real-World Examples

Restaurant Guest WiFi

A restaurant places a WiFi QR code on every table. Customers scan it, but some cannot connect. The problem is that the password was changed after the table cards were printed. Fix: Create a new QR code with the current password, test it, and replace the old table cards.

Office Visitor WiFi

An office displays a guest WiFi QR code in the reception area. Visitors scan it successfully but receive an authentication error. Fix: The QR code used the staff network name instead of the visitor network name. Create a new code using the correct guest SSID and password.

Airbnb Guest Access

An Airbnb host prints a WiFi QR code in the welcome book. Guests with newer phones connect, but some older devices fail. Fix: The router is configured for WPA3-only security. Enable WPA2/WPA3 mixed mode if appropriate, then create and test a new QR code.

Hotel Room WiFi

A hotel room QR code scans correctly but opens a connection prompt without internet access. Fix: The QR code connects guests to the WiFi network, but the hotel also requires a captive portal login. Add instructions next to the code: “Scan to connect, then open any browser to complete guest login.”

Event Venue WiFi

An event organizer shares WiFi through a QR code on a large screen. Guests cannot scan it from the back of the room. Fix: The code is too small for the viewing distance. Increase its size, use stronger contrast, and display it longer on screen.

Frequently Asked Questions

Fix Your WiFi Connection Issues in Seconds

Most WiFi QR code problems come down to one detail: the password, SSID, security type, hidden-network setting, or QR image quality does not match the real network.

Start by checking the credentials manually, confirm that your guest network is active, test the QR code on multiple devices, and inspect the final printed version. If anything has changed, create a fresh code rather than trying to repair an outdated one.