Como usar o conversor
- Monte a lista no Excel ou no Google Sheets: a URL antiga na primeira coluna e a nova na segunda. Tipo e data final são opcionais.
- Copie as células e cole na caixa acima, ou abra um CSV ou TXT.
- Leia a lista de problemas: cada linha mostra o campo, o que está errado e a sugestão.
- Pegue o CSV pronto (copiar ou baixar) e importe no Admin, em Storefront > Redirects > Import, ou pela linha de comando.
Em Opções você escolhe o tipo usado quando a linha não informa, o formato das datas da sua planilha, o domínio da loja (para transformar destinos do próprio domínio em caminho relativo) e se as cadeias devem ser resolvidas.
O que a VTEX documenta e o que o conversor confere
As regras vêm de duas páginas oficiais: a do Admin (Storefront > Redirects) e a da CLI do VTEX IO. O que a VTEX documenta aparece como erro; o que ela não documenta aparece como aviso.
- Separador: o CSV do Admin precisa ter ponto e vírgula. Vírgula e tabulação não são aceitas, e o Google Sheets exporta com vírgula por padrão. O CSV baixado aqui sai com ponto e vírgula.
- Origem (from): só caminho relativo, sem o domínio. Curinga e variável não são aceitos. Rotas predefinidas, como home, login e conta, não aceitam redirect.
- Destino (to): caminho relativo (/camisas/p) ou URL completa (https://outraloja.com). Também sem curinga nem variável.
- Tipo (type): TEMPORARY devolve 302 e PERMANENT devolve 301.
- Data final (endDate): em mm/dd/yyyy, só nos temporários; nos permanentes fica vazia. O Admin diz que o temporário exige a data.
- Cabeçalho: a VTEX pede que a primeira linha do arquivo não seja alterada.
- Avisos (não documentados): cadeias de redirects, laços, mesma origem com destinos diferentes, linhas repetidas, origem com query string e data final que já passou.
As quatro colunas
from: a URL antiga, como caminho (por exemplo,/blusa/p).to: a URL nova, como caminho ou URL completa.type:PERMANENTouTEMPORARY.endDate: data final emmm/dd/yyyy, só para TEMPORARY.
Esses nomes vêm da página da CLI. A página do Admin não lista os nomes das colunas do CSV: se o arquivo exportado do seu painel tiver outro cabeçalho, cole a primeira linha dele no campo "Cabeçalho do arquivo" e o conversor passa a usá-lo.
Cadeias e laços: por que resolver
Uma cadeia acontece quando o destino de um redirect é a origem de outro (A leva a B e B leva a C). O visitante e o Google passam por dois saltos para chegar ao destino final. O conversor mostra cada cadeia e, com a opção ligada, aponta A direto para C. Um laço (A leva a B e B volta a A) nunca chega a lugar nenhum: ele é marcado e não é alterado, porque só você sabe qual destino vale.
Migração de loja: um roteiro curto
- Liste todas as URLs antigas que têm tráfego ou links e a URL nova de cada uma.
- Use PERMANENT para o que mudou de endereço para sempre e TEMPORARY, com data final, para promoções e páginas sazonais.
- Antes de importar, exporte os redirects que já existem (botão Export no Admin ou o comando de exportação da CLI) para ter uma cópia.
- Importe e confira alguns casos no navegador: a VTEX diz que o processamento pode levar um tempo até os redirects valerem.
O que o conversor não faz
- Não envia nada para a VTEX: ele só prepara o arquivo.
- Não lê .xlsx: copie as células ou abra um CSV.
- Não confere se as URLs novas existem na sua loja.
- Não sabe o limite de linhas de um arquivo: a VTEX não o documenta.
Quer captar contatos de quem chega pelas URLs redirecionadas? Conheça a roleta de desconto para VTEX, com app oficial na VTEX App Store.
Perguntas frequentes sobre redirects em massa na VTEX
Como importar redirects em massa na VTEX?
Há dois caminhos. No Admin, em Storefront > Redirects, clique em Import, escolha o CSV, clique em Import File e depois em Save. Pela CLI do VTEX IO, instale o plugin (vtex plugins install redirects), faça login na conta e rode vtex redirects import com o caminho do CSV.
Por que o Admin recusa o CSV que exportei do Google Sheets?
Porque o Google Sheets exporta com vírgula como separador, e o Admin exige ponto e vírgula. Vírgula e tabulação não são aceitas. Este conversor entrega o CSV já com ponto e vírgula.
Quais são as colunas do CSV de redirects?
Na CLI do VTEX IO são quatro: from, to, type e endDate. A página do Admin não lista os nomes das colunas. Se o arquivo exportado do seu painel tiver outro cabeçalho, copie a primeira linha dele para o campo de cabeçalho do conversor.
O cabeçalho do CSV pode ser alterado?
Não. A VTEX avisa que, se a primeira linha for alterada, não será possível criar nem apagar redirects. Por isso o CSV gerado aqui não leva BOM nem nenhum caractere antes do primeiro nome.
Qual a diferença entre PERMANENT e TEMPORARY?
PERMANENT devolve o status 301 e TEMPORARY devolve 302. Use permanente quando a página mudou de endereço de vez e temporário para promoções e páginas sazonais.
Como preencho a data final (endDate)?
Em mm/dd/yyyy, por exemplo 12/31/2026, e só nos redirects TEMPORARY. Nos PERMANENT ela fica vazia. O Admin informa que o redirect temporário exige data final. O conversor lê datas como 2026-12-31 ou 31/12/2026 e converte.
Posso usar curinga ou expressão regular no redirect?
Não. A VTEX diz que não é possível criar redirects com curinga ou variável: cada redirect é uma origem e um destino exatos.
A origem (from) pode ter o domínio?
Não. A coluna from só aceita caminho relativo, e no Admin a origem é preenchida sem o nome do domínio. O conversor tira o domínio quando você cola uma URL completa.
O destino (to) aceita uma URL completa?
Sim. O destino aceita caminho relativo, como /camisas/p, ou URL completa, como https://outraloja.com.
Posso redirecionar a home, o login ou a conta?
Não. A VTEX diz que não dá para criar redirects de rotas predefinidas, como home, login e conta. O conversor marca essas origens como erro.
Posso ter mais de um redirect para a mesma URL?
A página do Admin informa que é possível definir vários redirects a partir de uma única URL. Como isso costuma ser engano numa planilha, o conversor mostra um aviso quando a mesma origem aparece com destinos diferentes.
Os parâmetros da URL (query string) são repassados?
Por padrão, não: a VTEX informa que os parâmetros de query string não são repassados nos redirects. O conversor avisa quando a origem tem query string, porque esse caso não é documentado.
Qual o limite de redirects por arquivo?
As páginas consultadas não informam limite de linhas ou de tamanho do CSV. A única quantidade citada é de 1.024 redirects, como limiar para o fluxo beta (flag enableRedirects) das lojas FastStore.
Como exporto os redirects que já existem?
No Admin, pelo botão Export na tela de Redirects. Pela CLI, com vtex redirects export seguido do nome do arquivo .csv. Vale exportar antes de importar para guardar uma cópia.
Como apago redirects em massa?
Pela CLI, com vtex redirects delete e o caminho de um CSV. O arquivo usa o mesmo modelo de quatro colunas da criação, com os redirects a remover abaixo da primeira linha.
Quanto tempo leva para os redirects valerem?
A VTEX diz apenas que, depois que o arquivo é processado, os redirects passam a valer e que isso pode levar algum tempo. Confira alguns casos no navegador depois da importação.
Preciso de alguma permissão para importar?
No Admin, o usuário precisa de um perfil com o recurso CMS Settings do License Manager. Pela CLI, é preciso instalar o VTEX IO CLI, o plugin de redirects e fazer login na conta.
O que é uma cadeia de redirects e por que evitar?
É quando o destino de um redirect é a origem de outro: A leva a B e B leva a C. Cada salto é mais uma requisição para o visitante e para o Google. O ideal é A apontar direto para C. O conversor mostra as cadeias e, se você deixar a opção ligada, resolve.
O que é um laço de redirects?
É quando o caminho volta à origem: A leva a B e B leva a A. A página nunca carrega. O conversor marca o laço e não altera essas linhas, porque só você sabe qual destino vale.
Funciona com Store Framework e com FastStore?
A VTEX informa que as lojas com Store Framework têm o recurso nativamente e que as lojas FastStore seguem um guia próprio de redirects. O formato do CSV descrito aqui é o do Admin e da CLI do VTEX IO.
O conversor lê arquivos .xlsx?
Não. Copie as células da planilha e cole na caixa, ou abra um arquivo CSV ou TXT. Isso evita enviar o seu arquivo a qualquer lugar.
Os dados da minha lista são enviados a algum servidor?
Não. A leitura, a validação e a conversão acontecem no seu navegador. Nada é enviado nem guardado pela ferramenta.
Outras ferramentas para lojas virtuais
No navegador, sem enviar nada, você também pode:
- validar a planilha de frete da VTEX antes de enviar
- redimensionar as fotos de produto para o tamanho da sua loja
- gerar códigos de barras EAN-13 e UPC-A
Outras ferramentas gratuitas
Todas rodam no navegador, sem cadastro e sem enviar os seus arquivos:
- Gerador de Link do WhatsApp: Crie links wa.me com mensagem pré-preenchida e use no site, no Instagram ou em anúncios.
- Gerador de QR Code: Crie QR Codes para links, WhatsApp, Instagram, Google Reviews, contatos e outros destinos.
- Calculadora de prêmios para roleta: Descubra quais prêmios colocar na sua roleta de desconto, a partir do segmento, do ticket médio e do objetivo.
- Redimensionar imagem: Redimensione imagens por pixels ou porcentagem, corte, ajuste a qualidade e baixe várias de uma vez em ZIP.
- Converter imagem: Converta imagens entre JPG, PNG e WebP sem mudar o tamanho em pixels, com qualidade ajustável e download em ZIP.
- Imagem para PDF: Junte uma ou várias imagens em um único PDF, uma por página, na ordem que você escolher.
- Etiqueta dos Correios: Gere etiquetas de endereçamento em PDF, várias de uma vez, com o CEP em código de barras. Só no navegador.