Dia a dia

O que um QR code realmente contém e por que alguns param de funcionar

Um QR code guarda um texto curto e nada mais. O que isso significa para os códigos que morrem e como ler o tamanho e a margem de um.

Uma grade QR envia uma linha reta a uma caixa de texto simples, e um desvio pontilhado termina numa caixa riscada: um redirecionamento morto.

Um QR code é uma grade de quadrados pretos e brancos que guarda um texto curto, normalmente entre alguns bytes e algumas centenas. Não há mais nada dentro: nem conta, nem rastreamento, nem conexão com a empresa cujo logo aparece ao lado. Quando você escaneia um código de um site, o celular lê dos quadrados o texto https://example.com/menu e oferece abri-lo, exatamente como se você tivesse digitado o endereço.

Essa também é a resposta para quem pergunta por que um código impresso parou de funcionar. Um código nunca expira sozinho. O que expira é aquilo para onde o texto aponta.

Por que alguns QR codes param de funcionar?

Porque o que está impresso às vezes não é o seu endereço. Muitos geradores, principalmente os que oferecem contagem de escaneamentos ou a promessa de trocar o destino depois, codificam um link curto no domínio deles, como servico-deles.example/x7Fq2. O servidor deles recebe o escaneamento, procura para onde você apontou e redireciona o celular. O código continua sendo lido normalmente e o texto dentro dele continua sendo um texto válido, mas se a conta vencer ou a empresa fechar, esse link curto responde com erro. Um cardápio impresso em 400 cartões de mesa vira 400 quadrados mortos.

Dá para conferir em dez segundos antes de imprimir qualquer coisa. Escaneie o código e, antes de abri-lo, leia o endereço que o celular mostra. Se o domínio não for o que você esperava, o código depende do servidor de outra pessoa enquanto existir.

Um código que leva diretamente o seu próprio endereço não tem intermediário para perder, e não precisa de nada do gerador depois que você baixou a imagem. O gerador de QR code deste site desenha a grade no seu navegador e codifica exatamente o texto que você digita, então a imagem vai funcionar enquanto o seu próprio link funcionar. O custo é que nada conta os escaneamentos e você não pode mudar o destino de um código já impresso. Se quiser um número, coloque-o no próprio endereço, como faz um parâmetro UTM, e leia na sua própria análise de acessos.

Como ler a versão de um código pelo tamanho?

O tamanho da grade se chama versão e segue uma única regra: a versão 1 tem 21 quadrados por lado e cada versão seguinte soma 4. Assim, um código com 29 quadrados de largura é a versão 3 e um com 41 é a versão 6. A especificação vai até a versão 40, com 177 quadrados por lado.

A versão é uma leitura direta de quanto texto existe: quanto mais bytes, maior a grade. Como guia aproximado, com o gerador deste site no nível de correção Médio:

Cada quadrado é um tamanho físico que precisa ser impresso ou exibido. Um endereço longo gera um código denso, que pede mão firme, câmera melhor e mais espaço. A melhora mais barata para um código difícil de escanear costuma ser um endereço mais curto, e quando o endereço tem acentos ou espaços, a codificação percentual o alonga ainda mais, porque cada um passa a ocupar três ou seis bytes.

Três dos quatro cantos levam as marcas grandes de quadrado dentro de quadrado chamadas padrões de localização. É com elas que o leitor encontra o código, calcula sua rotação e mede seu tamanho, e por isso um código é lido de cabeça para baixo ou na diagonal. Os códigos a partir da versão 2 também têm um padrão de alinhamento menor perto do canto inferior direito, que corrige uma superfície curva ou inclinada. Duas linhas pontilhadas entre os padrões de localização funcionam como régua para contar quadrados.

O que muda o nível de correção de erros?

Um QR code guarda mais do que o seu texto. Ele acrescenta dados extras, calculados a partir do texto, para que o leitor consiga reconstruir o que falta quando parte do código está suja, rasgada ou coberta. Você escolhe quanto acrescentar entre quatro níveis:

NívelRecupera cerca deUse para
L (Baixo)7%Uma tela limpa, onde o tamanho importa mais
M (Médio)15%O padrão sensato para tela ou impressão
Q (Alto)25%Códigos manuseados ou impressos pequenos
H (Máximo)30%Um logo cobrindo o meio

Paga-se em tamanho. Os mesmos 100 bytes de texto exigem a versão 5 (37 por 37) em Baixo, a versão 6 (41 por 41) em Médio e a versão 10 (57 por 57) em Máximo, segundo o codificador do gerador deste site. Essas porcentagens são o que a especificação promete, e um dano real que cubra os três padrões de localização ou um bloco de dados pode derrotar um código que em teoria está abaixo do limite.

Você não consegue ler o nível de um código só olhando. Ele fica guardado numa faixa de informação de formato ao lado dos padrões de localização, e só um leitor a decodifica. A pista visual honesta é indireta: se um endereço curto produz uma grade surpreendentemente grande, o código provavelmente foi feito com um nível alto.

Por que um código precisa de uma borda em branco?

A margem vazia em volta dos quadrados se chama zona silenciosa, e a especificação pede quatro quadrados de largura em cada lado. O leitor precisa ver onde o código termina e onde o fundo começa, e um código cortado rente, colocado sobre uma fotografia ou impresso sobre um padrão poluído não lhe dá nada para separar a borda do fundo. Quando um código que parece perfeito não escaneia, a primeira coisa a procurar é a falta da margem. O gerador deste site sempre deixa a borda de quatro quadrados na imagem baixada.

A outra falha comum é o contraste. Quadrados escuros sobre fundo claro é o que todo leitor espera. Quadrados claros sobre fundo escuro é um código que alguns leitores leem e outros não, então teste em mais de um celular.

O que este gerador não consegue fazer

O codificador daqui trabalha apenas em modo byte, nas versões 1 a 20 e não nas 40 completas. No modo byte uma carga de dígitos não é compactada com mais densidade como alguns geradores fazem, então um código numérico longo sai maior do que sairia em outros lugares. O teto depende do nível: em Baixo um código guarda no máximo 858 bytes de texto, em Máximo 382, e além disso a ferramenta avisa que há texto demais.

Ele também só faz códigos estáticos. Não há painel, nem edição posterior, nem contagem de escaneamentos, por projeto e pelo motivo da seção sobre códigos mortos. E confere a própria saída, não a foto de um código impresso, então o teste que conta continua sendo aproximar um celular da etiqueta pronta.

Para ver uma versão e uma zona silenciosa com os próprios olhos, digite um endereço no gerador de QR code, mude a configuração de qualidade e veja a grade crescer. Ele mostra a versão e a quantidade de quadrados por lado enquanto você digita, e nada sai do seu navegador.

O QR code mais comum da vida real é um que você já usou sem ler: o código de configuração da verificação em duas etapas. Como funcionam os códigos de um app autenticador mostra o texto que um deles carrega, e por que vale tratá-lo como uma senha.

Perguntas frequentes

O que fica guardado dentro de um QR code?

Um texto curto, codificado como bytes numa grade de quadrados, mais dados extras de correção de erros calculados a partir dele. Para um site, é o próprio endereço. O celular lê o texto e decide o que fazer com ele, e por isso o mesmo tipo de código pode levar um link, os dados de um wifi ou um cartão de contato.

Por que meu QR code parou de funcionar?

Em geral o código continua sendo lido normalmente e o problema está para onde ele aponta. Muitos geradores codificam um link de redirecionamento no próprio domínio, e quando essa conta acaba o redirecionamento falha. Escaneie o código e leia o endereço antes de abri-lo. Um código que leva diretamente o seu próprio endereço não depende do gerador.

Qual o tamanho máximo de um QR code e quanto texto cabe?

A especificação define as versões 1 a 40, de 21 por 21 quadrados até 177 por 177. A capacidade depende do nível de correção de erros: a versão 1 guarda 17 bytes de texto no nível mais baixo, e o gerador deste site, que vai até a versão 20, guarda até 858 bytes nesse nível. Mais correção de erros significa menos espaço para texto no mesmo tamanho.

Quanta margem um QR code precisa ao redor?

A especificação pede uma zona silenciosa de quatro quadrados em cada lado, na cor do fundo. Sem ela o leitor não encontra a borda do código, e um código que parece perfeito não vai escanear. Imprimir sobre um fundo poluído é a causa habitual.

Última atualização 14 de outubro de 2026