Altere muitas URLs de produtos de uma só vez atualizando os handles dos produtos em um único arquivo CSV. Este guia mostra como preparar seu arquivo, executar a importação e manter seu SEO seguro com redirecionamentos.
Quando usar
- Você renomeou produtos e deseja URLs limpas e legíveis.
- Você precisa alinhar os handles com uma nova convenção de nomenclatura.
- Você está corrigindo handles confusos, duplicados ou gerados automaticamente.
Como funciona (em palavras simples)
- A URL de um produto é construída a partir do seu handle. Exemplo: /products/cotton-shirt
- Se você mudar o handle, a URL muda.
- Para manter seu SEO, adicione um redirecionamento 301 da URL antiga para a nova.
Antes de começar
- Exporte um backup dos seus produtos (inclua pelo menos: handle, title).
- Escolha um momento seguro. Alterar URLs pode afetar o tráfego ao vivo.
- Decida como você lidará com os redirecionamentos (recomendado).
O que você pode atualizar de uma só vez
- Handle do produto (isso atualiza a URL).
- Opcional: Crie redirecionamentos 301 da antiga para a nova.
- Opcional: Atualize o título e a descrição de SEO junto com a mudança de URL.
Passos:
1. Exportar Produtos
No DataEase, crie uma Nova Exportação → Products. Inclua no mínimo: id, handle (opcionalmente title, seoTitle, seoDescription para revisar o SEO).
2. Editar handles no seu arquivo
Defina command = UPDATE e coloque o novo valor em handle. Use letras minúsculas, hífens (meu-novo-handle), evite espaços/caracteres especiais. Cada handle deve ser único.
3. (Opcional, mas recomendado) Planejar redirecionamentos
Alterar handles quebra URLs antigas, a menos que você crie redirecionamentos 301. Ative redirecionamentos automáticos na sua loja ou prepare uma importação/fluxo de trabalho de redirecionamentos separado.
4. Importar e validar
No DataEase, crie uma Nova Importação, carregue o arquivo, mapeie as colunas e execute a Validação. Abra o arquivo de validação e corrija quaisquer handles duplicados/inválidos.
5. Executar a importação
Em seguida, verifique alguns produtos na vitrine para confirmar que as novas URLs funcionam (e que os redirecionamentos resolvem das URLs antigas, se configurados).
Dicas
- Correspondência: prefira Product ID; use handle apenas se o ID estiver ausente.
- SEO: mudar o handle não altera seoTitle / seoDescription — edite-os se necessário.
- Se um handle já existir, a validação sinalizará um conflito; escolha um único.
- Redirecionamentos são cruciais para evitar 404s e preservar o SEO.
CSV Mínimo (exemplo)
| id | command | handle |
|---|---|---|
| 123 | UPDATE | new-handle |