> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WiFi QR code

> Let guests join your WiFi network without typing the password.

A WiFi QR code connects a phone to your network in one scan, with no typing. Use it for guests at home, in a café, an office or an event.

## Before you start

* Have your network name, password and security type. They're usually printed on a label on your router.

<Warning>
  A WiFi QR code stores the network details inside the code itself. If you change the network name or password later, the QR code pattern changes and you need to reprint it.
</Warning>

## Create it

<Steps>
  <Step title="Open the QR code builder">
    Click **Create QR** in the sidebar.
  </Step>

  <Step title="Choose WiFi">
    In **Choose QR type**, click **WiFi**.
  </Step>

  <Step title="Enter the network name">
    Type your network name in **WiFi Network Name**, exactly as it appears on your devices.
  </Step>

  <Step title="Choose the security type">
    In **Network Security Type**, pick the type your router uses. If you're not sure, keep **WPA/WPA2 (recommended)**.
  </Step>

  <Step title="Enter the password">
    Type your WiFi password in **Network Password**.
  </Step>

  <Step title="Mark a hidden network (optional)">
    If your network doesn't broadcast its name, turn on **My WiFi is a hidden network**.
  </Step>

  <Step title="Name your QR code (optional)">
    Type a name in **Name your QR Code**. Only you see it.
  </Step>

  <Step title="Go to the design step">
    Click **Next**.
  </Step>

  <Step title="Design and create">
    Customize the design (see [Design overview](/design/overview)), then click **Create QR**.
  </Step>
</Steps>

## Settings

| Setting | What it does |
| - | - |
| **WiFi Network Name** | Required, up to 40 characters. The name (SSID) of your network. It's case-sensitive. |
| **Network Security Type** | Required. **WPA/WPA2 (recommended)**, **WEP (less common)** or **No encryption (open network)**. Default: **WPA/WPA2 (recommended)**. |
| **Network Password** | Required for WPA/WPA2 and WEP, 8–40 characters. Hidden when you choose **No encryption (open network)**. |
| **My WiFi is a hidden network** | Turn on if your network doesn't broadcast its name. Phones can then join only with this code or by typing the name. |
| **Name your QR Code** | Optional, up to 40 characters. Only you see it. Default: **My WiFi QR Code**. |

## What people see when they scan

The phone's camera recognizes the network and offers to join it. One tap connects. No web page opens.

WiFi QR codes work differently from other types:

* **No short link.** The code holds the network details directly, so there's no **Custom short link** option.
* **No scan tracking.** Scans never pass through GetQR, so they don't appear in analytics.
* **No password protection.** The **Password** option on the design step isn't available for WiFi.
* **Changes need a reprint.** Editing the network details creates a new pattern.

## Use cases

* Guest WiFi at home or in a holiday rental.
* Customer WiFi in cafés, restaurants, salons and shops.
* Visitor WiFi in offices, meeting rooms and coworking spaces.
* Event and conference WiFi on badges, signs or table cards.
* Hotel room cards and welcome packs.

## Common issues

<AccordionGroup>
  <Accordion title="WiFi password must be at least 8 characters">
    WPA/WPA2 and WEP need a password of at least 8 characters. Check that you copied the full password. If your network has no password, choose **No encryption (open network)**.
  </Accordion>

  <Accordion title="The phone finds the network but can't connect">
    Check the password and security type against your router label. Network names and passwords are case-sensitive. Create a new code with the correct details and reprint it.
  </Accordion>

  <Accordion title="The phone doesn't offer to join a network">
    Make sure the phone's camera app supports QR codes, or use a QR scanner app. If your network is hidden, turn on **My WiFi is a hidden network**.
  </Accordion>

  <Accordion title="I changed my WiFi password and the printed code stopped working">
    The old details are stored in the printed code. Edit the QR code in **My QR Codes** with the new password, then download and reprint it.
  </Accordion>

  <Accordion title="My WiFi QR code shows no scans">
    This is expected. WiFi codes connect directly and never pass through GetQR, so scans can't be counted.
  </Accordion>
</AccordionGroup>

## What's next

<CardGroup cols={2}>
  <Card title="Add a frame" href="/design/frames" />

  <Card title="Print your QR code" href="/downloads/printing" />

  <Card title="Download formats" href="/downloads/formats-and-resolution" />

  <Card title="All QR code types" href="/qr-types/overview" />
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.