Usar mais de um domínio no seu espaço de trabalho
Mantenha vários domínios personalizados num espaço de trabalho — defina o principal, arquive os aposentados e escolha o domínio por link ou QR code.

Um espaço de trabalho comporta vários domínios ao mesmo tempo: um por marca, um por país ou um antigo mantido vivo por causa dos links já em circulação. Esta página trata de qual deles é usado por padrão e de como evitar que a lista vire barulho.
Disponibilidade
- Plano: Starter 1 domínio, Pro 5, Business 10, Advanced 50, Enterprise 1000. O plano gratuito não comporta nenhum.
- Onde: Domínios, na barra lateral.
Antes de começar
Cada domínio precisa do registro de DNS dele, então o segundo domínio dá o mesmo trabalho que o primeiro — veja Apontar seu domínio com CNAME ou registro A.
Defina o domínio principal
O domínio marcado como Domínio Principal vem selecionado no campo Link Curto sempre que alguém cria um link ou um QR code, e é por isso que ele importa mais do que parece: é ele que define o que o time inteiro publica por padrão.
- Abra Domínios e selecione Editar no domínio.
- Abra Opções avançadas e ligue Domínio Principal.
- Selecione Salvar alterações.

Só um domínio é principal por vez; marcar outro transfere a marcação.
Escolha outro domínio para um link específico
No construtor de links ou de QR codes, abra a lista de domínios à esquerda do campo Link Curto e escolha. Ela traz todos os domínios do espaço de trabalho mais os domínios compartilhados da CodeQR. A escolha vale só para aquele link e não altera o padrão.
Arquive um domínio que você não usa mais
Arquivado esconde o domínio das listas do dia a dia e o mantém plenamente operante: os links existentes continuam resolvendo e as estatísticas continuam somando. É a opção para quando o domínio de uma campanha terminou, mas os links dele ainda estão impressos em algum lugar.
- Domínios → Editar → Opções avançadas.
- Ligue Arquivado e selecione Salvar alterações.
Arquivar não é excluir, e a diferença é severa — veja Trocar ou remover um domínio sem perder os links.
Oriente o time com a URL do placeholder
A URL do Placeholder de Entrada define o endereço de exemplo mostrado no campo URL de destino do construtor para aquele domínio. Num domínio usado por um time e um produto, preenchê-la com um destino típico é um jeito discreto de indicar o que cabe ali. Ela é visível só dentro da CodeQR e não altera nada no link.
O que acontece ao passar do limite
Adicionar um domínio além da cota do plano é recusado. Baixar de plano não apaga os domínios que você já tem — eles ficam, junto com os links.
Faça o mesmo pela API
Não está disponível. Os endpoints de domínio da referência da API devolvem 404, então a lista de domínios, a marcação de principal e a de arquivado não podem ser lidas nem alteradas por um script hoje.
Links e QR codes, por outro lado, aceitam o domínio como campo normal:
curl -X POST https://api.codeqr.io/links \
-H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/es","domain":"go.example.com","key":"verano"}'Verifique se funcionou
Crie um link sem mexer na lista de domínios e confira se o link curto usa o domínio que você marcou como principal. Depois confirme que um link do domínio arquivado continua resolvendo:
curl -sSI https://antigo.example.com/campanha
HTTP/2 302 location: https://example.com/campanha
Solução de problemas
O domínio novo não aparece no construtor
Recarregue o construtor. Um domínio ainda em verificação pendente aparece na lista, mas os links criados nele não resolvem enquanto o DNS não estiver no lugar.
Dois domínios estão marcados como principal
Não é possível — marcar um limpa o outro. Se a lista parecer errada, recarregue a página Domínios.
Um domínio arquivado sumiu do painel
É o que Arquivado faz. Os links dele continuam funcionando; desligue a chave para trazê-lo de volta à vista.
Cheguei ao limite e preciso de mais um
Libere a vaga removendo um domínio de que você realmente não precisa mais — leia Trocar ou remover um domínio sem perder os links antes, porque a remoção é destrutiva — ou mude para um plano com cota maior.