QR Code de Wi-Fi: como criar e como funciona
Esse formato não abre página nenhuma: ele entrega ao sistema operacional os dados da rede e o celular se conecta sozinho. É o QR que mais economiza atrito em estabelecimento com público — ninguém mais precisa soletrar senha no balcão.
Com JavaScript ativo, o código é montado no seu navegador: nada do que você digita chega aos nossos servidores. O símbolo é estático e não expira.
Como o formato funciona por dentro
O conteúdo começa com a palavra-chave WIFI: e traz pares campo-valor separados por ponto e vírgula, terminando com dois pontos e vírgulas. O leitor reconhece esse prefixo, não abre navegador e mostra a caixa “conectar à rede”.
Caracteres especiais na senha precisam de escape com barra invertida: ponto e vírgula, dois-pontos, vírgula, aspas e a própria barra. Uma senha como casa;2026 tem que ser escrita casa\;2026, senão o leitor corta a senha no ponto e vírgula e a conexão falha sem explicação.
No iPhone, a leitura acontece pela câmera nativa desde o iOS 11 e a conexão é imediata. No Android, o suporte é nativo desde o Android 10; em versões anteriores depende do leitor do fabricante, e alguns aparelhos antigos só reconhecem o formato dentro do app Google Lens.
Redes com portal de autenticação — aquelas que pedem aceite de termos numa página depois de conectar — continuam pedindo. O QR resolve a senha, não o portal.
Campos do formato
O conteúdo do símbolo segue esta estrutura: WIFI:T:WPA;S:{nome da rede};P:{senha};H:false;;
| Campo | O que é |
|---|---|
T | tipo de segurança: WPA (cobre WPA, WPA2 e WPA3), WEP ou nopass para rede aberta. |
S | o SSID exatamente como aparece na lista de redes — maiúsculas, minúsculas, espaços e acentos contam. |
P | a senha. Fica legível para quem decodificar o símbolo, então não use aqui a senha da rede administrativa. |
H | true se a rede for oculta (não aparece na busca). Com false, o celular procura o SSID na lista normal. |
Compatibilidade: iOS 11+ pela câmera nativa; Android 10+ nativo; Android 8 e 9 pelo Google Lens ou leitor do fabricante.
Fonte: ZXing — Barcode Contents (consulta em 08/2026). Página revisada em 01/09/2026.
De que tamanho imprimir
Com o conteúdo de exemplo acima, o símbolo sai na versão 4 (33×33 módulos) usando correção M. A regra prática é dividir a distância de leitura por dez — e nunca deixar cada módulo abaixo de 0,4 mm, que é o piso para impressão comum:
| Distância de leitura | Situação típica | Lado do símbolo | Cada módulo | Arquivo a 300 dpi |
|---|---|---|---|---|
| 20 cm | cartão de visita, etiqueta, embalagem pequena | 2 cm | 0,49 mm | 236 px |
| 30 cm | mesa de restaurante, balcão, folheto | 3 cm | 0,73 mm | 354 px |
| 50 cm | cardápio de parede, mural, prateleira | 5 cm | 1,22 mm | 591 px |
| 1 m | cartaz A3, vitrine de loja | 10 cm | 2,44 mm | 1.181 px |
| 2 m | banner, placa de imóvel, lateral de veículo | 20 cm | 4,88 mm | 2.362 px |
| 5 m | fachada, telão, painel de evento | 50 cm | 12,2 mm | 5.906 px |
Some sempre a zona quieta: 4 módulos de margem branca em volta do símbolo, exigência da ISO/IEC 18004 e a causa mais comum de código que não lê. A calculadora de tamanho refaz essa conta com o seu conteúdo real.
Erros comuns no QR Code de Wi-Fi
| Erro | O que acontece |
|---|---|
| Senha com ponto e vírgula sem escape | O leitor corta a senha no primeiro ;. Escreva \; — o gerador aqui já faz isso automaticamente. |
| SSID digitado com diferença de maiúscula | Cafe Central e CAFE CENTRAL são redes diferentes para o celular. Copie o nome da própria configuração do roteador. |
| Marcar WPA numa rede aberta | Rede sem senha exige T:nopass. Com WPA declarado e senha vazia, o Android recusa a conexão. |
| Trocar a senha do roteador e esquecer o cartaz | O símbolo continua com a senha antiga. Toda troca de senha exige reimprimir o código. |
O mesmo conteúdo nos quatro níveis de correção
A correção de erro Reed-Solomon é o que permite ler um código riscado, sujo ou parcialmente coberto. O preço é espaço: quanto mais correção, mais codewords do símbolo são gastos com redundância e maior fica o desenho. Com o conteúdo de exemplo desta página, a diferença é esta:
| Nível | Recupera | Versão | Módulos | Codewords de correção | Lado mínimo |
|---|---|---|---|---|---|
| L | 7% | 4 | 33×33 | 20 | 2 cm |
| M | 15% | 4 | 33×33 | 36 | 2 cm |
| Q | 25% | 5 | 37×37 | 72 | 2 cm |
| H | 30% | 6 | 41×41 | 112 | 2 cm |
Do nível L ao H, o símbolo sai de 33×33 para 41×41 módulos — e o lado mínimo de impressão cresce na mesma proporção. Para o QR Code de Wi-Fi, o nível M é o equilíbrio recomendado; suba para Q ou H quando o código for para superfície que suja, arranha ou recebe sol direto, ou quando você for colocar um logotipo no meio.
Antes de mandar para a gráfica
- Leia o próprio código. Abra a câmera do seu celular e confira se o resultado é exatamente o esperado — no QR Code de Wi-Fi, confira T caractere por caractere.
- Teste em três aparelhos. Um iPhone, um Android recente e um aparelho antigo. A leitura que falha só no antigo indica símbolo pequeno demais.
- Imprima uma prova no tamanho final, em papel comum, e leia a 30 cm e à distância real de uso.
- Confira a margem branca. São 4 módulos em volta do símbolo — o arquivo SVG baixado aqui já vem com ela; o risco é a gráfica cortar no acabamento.
- Não inverta as cores. Módulos escuros sobre fundo claro. O contrário falha em boa parte dos leitores, por mais bonito que fique.
- Guarde o arquivo SVG. Ele é vetorial e reimprime em qualquer tamanho sem perder qualidade; o PNG, não.
QR Code de Wi-Fi por segmento de negócio
O mesmo formato rende de maneira diferente em cada ramo — muda o ponto onde o código é colado, o material que aguenta o ambiente e o texto que vai ao lado. Estas páginas trazem o caso concreto:
- Restaurantegarçom parado explicando cardápio e fila no caixa na hora de fechar a conta
- Pizzariatelefone tocando enquanto o balcão enche e o cardápio de sabores muda toda semana
- Lanchonetefila no balcão e troco que não fecha
- Cafeteriasenha de Wi-Fi soletrada dez vezes por dia e cliente que não sabe do café especial da…
- Bardividir a conta entre seis pessoas com uma maquininha só
- Sorveteriafila na vitrine e informação de alergênico que ninguém consegue mostrar
- Salão de belezaagenda cheia de furo por falta de confirmação e cliente que some entre um serviço e outro
- Barbeariafila de espera sem controle e cliente que aparece na hora cheia
- Hotelpasta de informações no quarto que ninguém abre e recepção respondendo a mesma pergunta o…
- Pousadarecepção que atende poucas horas e hóspede sem saber onde comer
- Lava-jato e estética automotivafila sem previsão e cliente que não sabe quando o carro fica pronto
- Condomínioaviso no elevador que ninguém lê e reserva de área comum por caderno na portaria
Perguntas frequentes
Qualquer pessoa consegue ver a senha no QR Code?
Funciona em iPhone e Android?
Preciso de aplicativo para o cliente conectar?
WIFI: e mostra o convite de conexão. Nenhum app extra é necessário nos aparelhos atuais.