Handle e URL de produto na Shopify: o que é, como mudar e como funciona no CSV

O que é o handle de um produto na Shopify?

O handle é o identificador único de um produto e aparece na URL da página do produto. A Shopify o gera quando você cria o produto, com base no título. Segundo a ajuda de CSV da Shopify, um produto chamado "Black Sunglasses" recebe o handle black-sunglasses.

Na sua loja, a página desse produto fica no caminho /products, então a URL termina em /products/black-sunglasses. O handle é a última parte. Você pode personalizá-lo.

A ajuda de produtos da Shopify chama o campo de "URL handle" e diz que ele altera parte do endereço web do produto. O endereço não pode conter espaços.

Como mudar a URL de um produto na Shopify

Abra o produto e vá até a seção "Search engine listing". Clique no ícone de lápis. Os campos são título da página, meta descrição e "URL handle".

1. 1
   Vá em Produtos no admin da Shopify e abra o produto.
2. 2
   Em "Search engine listing", clique no ícone de lápis.
3. 3
   Altere o "URL handle". Encurte-o e mantenha as palavras que as pessoas pesquisariam.
4. 4
   Salve o produto.

A visão geral de SEO da Shopify recomenda URLs descritivas, com hifens entre as palavras. Um handle curto como black-sunglasses é mais fácil de ler do que um longo copiado do título de um fornecedor.

O que acontece com a URL antiga?

Depois que o handle muda, o endereço antigo deixa de apontar para o produto. Quem seguir um link antigo, vindo de um resultado de busca, de um e-mail ou de outro site, pode cair em um erro de "Página não encontrada".

A ajuda da Shopify documenta uma opção "Create a URL redirect", selecionada por padrão, quando você muda o endereço de uma página. A ajuda de coleções oferece o mesmo tipo de redirecionamento a partir do handle anterior. A página de ajuda de produtos não menciona isso. Então não presuma que aconteceu: depois de salvar, abra a URL antiga do produto. Se aparecer um 404, adicione você mesmo o redirecionamento (próxima seção).

Como criar um redirecionamento de URL na Shopify

1. 1
   No admin da Shopify, vá em "Content → Menus".
2. 2
   Clique em "View URL Redirects" e depois em "Create URL redirect".
3. 3
   Em "Redirect from", digite a URL antiga, como /products/old-handle.
4. 4
   Em "Redirect to", digite a nova URL. Use uma URL relativa para um destino no seu domínio principal.
5. 5
   Clique em "Save redirect". Ele entra em vigor imediatamente.

Dois limites da ajuda de redirecionamento de URL da Shopify. Um redirecionamento só funciona em uma URL quebrada que mostra um 404. Se a URL antiga ainda carrega uma página válida, ela não será redirecionada. E uma loja padrão pode ter até 100.000 redirecionamentos.

Como os handles funcionam em um CSV de produtos

No CSV de produtos atual da Shopify, a coluna do handle se chama "URL handle". Ela é o vínculo da linha com um produto. A ajuda da Shopify descreve o comportamento:

• Correspondência: o handle decide qual produto existente uma linha atualiza.
• Sobrescrever ativado: se você selecionar "Overwrite products with matching handles", os valores do arquivo substituem os do produto existente.
• Sobrescrever desativado: produtos com handles correspondentes são ignorados na importação.
• Handle em branco: em um produto novo, a Shopify o gera a partir do Title.
• Variantes: repita o handle em cada linha de variante. Deixe Title, Description, Vendor e Tags em branco nessas linhas.
• Imagens extras: cada imagem adicional ganha a sua própria linha, com o handle e a URL da imagem.

O handle é obrigatório para atualizações (junto com o Title). Para produtos novos, é obrigatório apenas quando você adiciona variantes. A ajuda da Shopify não diz o que acontece quando o mesmo handle aparece duas vezes em um arquivo fora do padrão de linhas de variante, então confira o seu arquivo com o validador de CSV antes de enviar. O processo completo está no guia de importação CSV na Shopify.

Redirecionamentos ao mudar uma loja para a Shopify

Se você está vindo de outra plataforma, as URLs antigas dos seus produtos não vão seguir o padrão /products/{handle} da Shopify. Visitantes e mecanismos de busca que acessam as URLs antigas recebem um 404. A solução é um redirecionamento de cada URL antiga para a nova.

Você pode adicioná-los um a um ou importá-los. Em "Content → Menus → View URL Redirects", clique em "Import", depois em "Add File", escolha o seu CSV e clique em "Upload file". Revise a importação e clique em "Import redirects". A Shopify oferece ali um modelo de CSV de exemplo. A página de ajuda não lista nomes de colunas nem limites de arquivo, então comece pelo modelo.

Os nossos guias de plataforma cobrem a importação de produtos em si: do WooCommerce para a Shopify, Wix e outras. Planeje os redirecionamentos ao mesmo tempo, antes de trocar o domínio.

Dicas para handles limpos

• Mantenha os handles curtos: as principais palavras do produto, separadas por hifens.
• Use letras minúsculas e números. Evite espaços e caracteres especiais.
• Defina o handle ao criar o produto, para nunca precisar mudá-lo.
• Antes de uma alteração de handles em massa, exporte os seus produtos como backup. Veja exportar produtos da Shopify.
• Depois de uma alteração, teste a URL antiga e a nova.
• Mantenha uma lista das URLs antigas e novas. Você vai precisar dela para os redirecionamentos.

Handles e produtos importados

Nós criamos o 1Click, um app da Shopify que importa produtos da Amazon, do AliExpress, do eBay ou de uma loja Shopify que você gerencia. Os produtos que ele cria são produtos comuns da Shopify. Depois, você pode abri-los e editar o "URL handle" em "Search engine listing" como em qualquer outro. O 1Click não cria redirecionamentos de URL para você.