Redirecionamentos de URL no Shopify: os limites, testados.

Uma documentação de ajuda melhor

Escrito e mantido para as marcas e agências que estão conduzindo uma migração de site. Principalmente se você é uma equipe pequena que precisa aproveitar cada hora. Este guia ajuda você a montar uma estratégia para concluir com precisão os redirecionamentos 301 se estiver migrando para o Shopify. Especificamente, este documento pode ajudar você se estiver:

• Migrando do Wordpress
• Migrando do Magento
• Migrando do Salesforce
• Migrando do Sitecore
• Migrando do BigCommerce
• Migrando do Webflow
• Migrando de um site PHP feito em casa

Se você está tocando um projeto que envolve mapeamentos complexos de redirecionamentos 301 e precisa de um time que vive e respira esse tipo específico de trabalho, fale conosco.

A lógica de redirecionamento de URL do Shopify: visão geral

A documentação de ajuda oficial do Shopify sobre redirecionamentos de URL está aqui. É um documento enxuto, com diretrizes gerais que um gestor de loja Shopify pode consultar para adicionar redirecionamentos 301 individuais e em massa. Falta detalhamento sobre os tipos de URL que uma loja Shopify consegue suportar nativamente, e este relatório existe para preencher essas lacunas.

Resumo dos achados sobre a funcionalidade de redirecionamento de URL do Shopify

• A lógica de redirecionamento de URL do Shopify é bastante robusta.
• No nosso teste com 100 formatos diferentes de string de URL, o Shopify suportou funcionalmente 99 dos 100 tipos.
• Uma rota real da vitrine sempre vence um redirecionamento, em silêncio.
• O sistema nativo não suporta curingas para redirecionamentos de URL.
• Atualizar caminhos de redirecionamento já existentes foi fácil com a ferramenta de importação, desde que você siga as regras não documentadas do Shopify.
• Existem limites para o número total de redirecionamentos que lojas Shopify e ShopifyPlus vão gerenciar.
• Existem limites para o número total de caracteres de uma string de redirecionamento de URL.
• A prevenção de cadeias é parcial. O Shopify bloqueia uma direção, e a ordem de criação ainda pode deixar uma cadeia viva.
• Existem muitas exceções e regras para URLs com parâmetros.
• A interface de gerenciamento de redirecionamentos de URL é amigável, mas se beneficiaria de mais detalhes.
• Os testes não examinaram as opções de redirecionamento disponíveis para Hydrogen e Oxygen.
• Damos ao sistema atual de redirecionamento de URL do Shopify uma nota de utilidade de 85%.

A nota caiu 5% pela ausência de suporte a curingas, 1% pelo único tipo de string de URL que ele não suportou, 2% pelos limites de comprimento de caracteres, 3% pelo comportamento estranho com URLs parametrizadas e 4% por informações essenciais de gestão que faltam na experiência de uso dos redirecionamentos.

Testado pela primeira vez em 19 de junho de 2024. Retestado em 27 de julho de 2026 contra uma loja Shopify real de plano padrão, pela Admin GraphQL API e por requisições reais à vitrine. O que mudou entre os dois está listado no changelog.

Nossa metodologia de teste de redirecionamentos

Queríamos responder algumas perguntas com os nossos testes, para ajudar a evitar armadilhas nas regras de redirecionamento 301 do Shopify:

• Quais caracteres ou combinações de string o sistema de redirecionamento de URL não suporta?
• Existem limites para o comprimento da string de URL?
• Existe um número máximo de registros para importações em massa?
• O sistema suporta redirecionamentos com curinga?
• Existe alguma formatação ou conversão automática de strings depois da importação que altere os dados originais?

Para referência, aqui está nossa lista completa de URLs que usamos para testar essas diferentes condições. Os testes foram conduzidos em um plano padrão do Shopify (não no ShopifyPlus).

11 achados para ajudar com os redirecionamentos do Shopify

O Shopify não se dá bem com estes tipos de string de URL

Um formato de string entre os cem que testamos não pode ser redirecionado de forma confiável. O Shopify aceita o registro e o guarda, mas um navegador que o requisita recebe um 404. É uma string que carrega um ponto e vírgula depois do operador de igual, como:

/page?param=;semicolon

O que chama atenção nessa string é que o sistema do Shopify converte o caractere especial ponto e vírgula no seu valor codificado em URL, ficando assim na tabela de redirecionamentos:

/page?param=%3Bsemicolon

Quando você digita a string de URL sem codificar na barra de endereços de um navegador, ela devolve um erro 404.

Esse comportamento foge do tratamento dado aos outros caracteres especiais. Se uma string de URL com caracteres sem codificar é digitada na barra de endereços, como o caractere de chave direita:

/page?param=}

O Shopify a codifica automaticamente quando a requisição da URL chega e nenhum erro 404 acontece.

/page%7Drightbrace

Também vale notar que outras variações de uma string de URL com ponto e vírgula sem codificar são validadas pelo sistema de redirecionamentos do Shopify, como:

O 404 só é disparado quando um ponto e vírgula sem codificar aparece depois do operador de igual, e a falha está na hora da requisição e não na importação. O Shopify guarda o registro com o ponto e vírgula codificado como %3b, e uma URL de entrada carregando o ponto e vírgula cru nunca coincide com o registro codificado. Pedir a forma codificada devolve 301 normalmente, então, onde você controla os links de entrada, codificar o ponto e vírgula resolve. Onde o ponto e vírgula cru chega de links externos que você não controla, esse formato não pode ser redirecionado de forma confiável.

Sem suporte a redirecionamentos com curinga no Shopify

Redirecionamentos com curinga continuam na lista de desejos de muitos usuários do Shopify. Os fóruns de suporte estão cheios de pedidos por esse recurso. Até hoje o Shopify permanece em silêncio sobre onde isso ficaria no roadmap do produto.

Por enquanto, quem planeja mudar para o Shopify precisa entender que o Shopify e o ShopifyPlus nativos não oferecem essa opção.

O que são redirecionamentos com curinga?

Redirecionamentos com curinga são um tipo de redirecionamento de URL que permite redirecionar várias URLs que coincidem com um padrão específico para um único destino. Isso é particularmente útil ao migrar um site, reorganizar conteúdo ou gerenciar grandes quantidades de URLs parecidas. Em vez de configurar redirecionamentos individuais para cada URL, você usa um caractere curinga (normalmente *) para representar qualquer sequência de caracteres.

Suponha que você esteja reestruturando seu blog e movendo todos os posts do diretório /blog/ para /articles/. Em vez de configurar redirecionamentos individuais para cada post, você pode usar um redirecionamento com curinga:

From: /blog/*
To: /articles/*

This wildcard redirect will automatically map:

/blog/post1 to /articles/post1
/blog/post2 to /articles/post2
/blog/post3 to /articles/post3

Isso simplifica o processo de redirecionamento e garante que todas as URLs sob /blog/ sejam redirecionadas sem atrito para a nova localização em /articles/. As lojas padrão do Shopify e do ShopifyPlus não incluem essa capacidade sem o apoio de um app.

A parte que custa tráfego às pessoas é que o Shopify aceita a sintaxe de curinga sem reclamar. Um registro criado como /old-blog/* é salvo, aparece na tabela de redirecionamentos e não reporta nenhum erro. O asterisco é guardado como caractere literal, então a única URL com a qual ele algum dia vai coincidir é uma que contenha literalmente um asterisco. Isso é pior do que uma rejeição direta, porque nada sinaliza a falha até o tráfego real começar a devolver 404. Expanda qualquer curinga do seu arquivo de redirecionamentos para caminhos explícitos antes de importá-lo.

O Shopify faz o possível para evitar a criação de cadeias de redirecionamento

O Shopify tem uma proteção contra cadeias, e vale entender os limites dela antes de confiar. Ele rejeita um redirecionamento cujo destino já é a origem de outro redirecionamento, com Target can't redirect to another redirect. Ele rejeita um redirecionamento que aponta para si mesmo, com Target can't be the same as path, e bloqueia laços diretos de duas pontas.

Neste teste, os registros de URL que tentamos criar foram os seguintes, e não foram permitidos:

O que a proteção não faz é verificar o sentido inverso. Crie /a para /b enquanto não existe nada em /b, depois crie /b para /c, e os dois são aceitos. O Shopify nunca revisita o primeiro registro, e você fica com uma cadeia viva:

GET /a
  301 to /b
  301 to /
  final: 200, 2 hops

Só a ordem de criação decide se uma cadeia se forma. As importações em massa aplicam as linhas na ordem do arquivo, e arquivos de migração raramente são ordenados para evitar isso, então a proteção não é algo com que se possa contar. Depois de qualquer importação grande, faça uma amostragem dos seus redirecionamentos e conte os saltos:

curl -sIL https://yourstore.com/old-path -o /dev/null -w "hops: %{num_redirects}
"

Qualquer coisa acima de 1 é uma cadeia.

O que são cadeias de redirecionamento?

Cadeias de redirecionamento acontecem quando uma URL é redirecionada para outra URL, que por sua vez redireciona para mais outra URL, criando uma sequência ou “cadeia” de redirecionamentos. Isso pode acontecer sem intenção quando vários redirecionamentos são configurados ao longo do tempo sem uma gestão adequada.

Cadeias de redirecionamento são problemáticas porque podem deixar o carregamento das páginas mais lento, prejudicar o SEO e criar uma experiência ruim para o usuário. Cada redirecionamento a mais adiciona latência, já que o navegador precisa seguir cada passo da cadeia antes de chegar ao destino final.

Por exemplo, se você tiver os seguintes redirecionamentos configurados:

/old-page redirects to /new-page
/new-page redirects to /latest-page

Quando um usuário visita /old-page, ele é primeiro redirecionado para /new-page e depois redirecionado imediatamente de novo para /latest-page, resultando em uma cadeia de redirecionamento.

Novas regras a seguir ao configurar redirecionamentos no Shopify

A nossa maior descoberta nos testes é que a documentação do Shopify está desatualizada, e que a regra por trás dela é mais simples do que a lista documentada de prefixos reservados.

Uma rota real da vitrine sempre vence um redirecionamento. Onde uma página existe de verdade em uma URL, o Shopify serve a página e ignora o redirecionamento. O registro é aceito, fica na sua tabela de redirecionamentos e não faz nada. Sem erro, sem aviso. O prefixo não é a variável. A existência de uma rota é:

/products/ai-skillset-package-001  ->  200, the product page
/products/zz20260727               ->  301, the redirect fires

Mesmo prefixo, resultado oposto. Isso vale para todo produto, coleção, página e artigo de blog ativo na sua loja, e não apenas para os quatro caminhos que o Shopify documenta. Um redirecionamento em uma URL de produto publicado fica inerte até aquele produto parar de resolver, o que faz a sequência importar durante uma migração: despublique ou apague primeiro o recurso antigo, depois confirme que o redirecionamento dispara.

Segundo o Shopify, se você tentar redirecionar qualquer coisa que comece com estes prefixos reservados, suas regras de redirecionamento não serão criadas:

/apps
/application
/cart
/carts
/orders
/services
/products
/collections
/collections/all

Descobrimos que isso não é verdade.

/services é a exceção deste grupo, e se comporta ao contrário do resto. Um redirecionamento em /services sozinho devolve 301. Um redirecionamento em qualquer coisa abaixo dele, como /services/consulting, devolve 404 mesmo que o registro seja salvo sem reclamação. Retestamos isso quatro vezes ao longo de cerca de 45 segundos para descartar atraso de propagação, com o registro presente na tabela o tempo todo. Todos os outros prefixos deste grupo funcionaram com subdiretórios.

A causa provável é que o Shopify roteia /services/* internamente para proxies de app e endpoints de sistema, de forma que essas requisições nunca chegam à tabela de redirecionamentos, embora não tenhamos verificado o mecanismo diretamente. Se você está migrando um site com uma seção /services/, nenhum desses redirecionamentos vai disparar. Remapeie-os para outra estrutura de caminho, ou trate-os na sua camada de DNS ou de proxy.

Criar e atualizar redirecionamentos de URL é fácil no Shopify

A criação de um novo redirecionamento é simples no Shopify. Eles dão duas opções aos usuários:

• Criação de redirecionamento de URL individual, um de cada vez
• Criação de redirecionamentos em massa, por arquivo CSV - aqui está o modelo mais recente para essa importação.

Ao adicionar URLs ao sistema do Shopify, os usuários podem inserir caminhos de URL relativos, sem domínio de topo, para a origem (from), e caminhos de URL absolutos ou relativos no destino (to). Exemplo:

/example_product.php

Criando redirecionamentos de URL individuais

As regras de redirecionamento que o Shopify tem em vigor não permitem criar o mesmo redirecionamento de URL duas vezes pela interface de redirecionamento individual.

Assim que uma URL está na listagem da tabela ‘Redirect from’, se você tentar adicioná-la de novo vai receber um erro.

Se quiser atualizar o registro individual da URL, você precisa encontrá-lo na tabela de redirecionamentos ou usar o método de importação em massa. Se uma URL que já existe estiver incluída em um arquivo de importação em massa, o campo ‘Redirect to’ do registro será atualizado com o valor do arquivo CSV.

Nosso conselho é sempre importar redirecionamentos em lotes gerenciáveis e eficientes. Por exemplo, se você tem 10.000 redirecionamentos de URL, importe 1.000 por vez e confira cada lote se tiver tempo. É melhor pegar erros em conjuntos pequenos do que caçá-los em conjuntos grandes.

Tenha cuidado com redirecionamentos de URL em massa no Shopify

Para criar redirecionamentos em massa, preencha o arquivo CSV com os cabeçalhos que o Shopify exige, crie os mapeamentos 1:1 e garanta que todas as URLs estejam formatadas como caminhos relativos. Se você criar um arquivo com caminhos absolutos nos campos ‘Redirect from’ ou ‘Redirect to’, o Shopify vai resolver por conta própria. Veja alguns cenários:

A lição é conferir seu arquivo de importação duas vezes antes de usá-lo. Caso contrário, você vai criar regras de redirecionamento de URL que não operam da maneira que você precisa.

Se um registro de redirecionamento já existe na tabela e os mesmos valores estão incluídos no arquivo de importação, o Shopify vai atualizar o registro com os dados mais recentes do arquivo. Na nossa opinião isso é extremamente útil, desde que você queira que aquele registro seja atualizado. Mais um motivo para conferir os dados duas vezes.

O Shopify não impõe um teto de linhas por arquivo. Uma única importação de 1.051 linhas passou sem nenhuma falha em 48 segundos, o que dá cerca de 1.300 linhas por minuto.

Lotes de aproximadamente 1.000 linhas ainda valem a pena, por um motivo diferente de um limite rígido. Arquivos menores falham de forma mais legível. Se uma importação de 20.000 linhas dá errado, você tem muito menos noção de quais linhas causaram o problema do que se tivesse rodado vinte arquivos e acompanhado as contagens. Leia createdCount, updatedCount e failedCount depois de cada importação, porque um failedCount diferente de zero é o único sinal que você recebe de que linhas foram descartadas.

Um caminho que já está na tabela de redirecionamentos tem o destino sobrescrito e é reportado em updatedCount, mantendo o id de registro original. Isso torna seguro reexecutar uma importação CSV, o que é útil no meio de uma migração. Também significa que um arquivo desatualizado vai sobrescrever em silêncio as correções que você fez à mão desde a última importação.

O limite do Shopify para registros de redirecionamento de URL

Toda coisa boa tem seu limite, e as regras de redirecionamento do Shopify não são diferentes. Existem dois patamares para redirecionamentos de URL.

Planos Shopify (não Plus):

Máximo de 100.000 redirecionamentos de URL

Planos ShopifyPlus:

Máximo de 20.000.000 de redirecionamentos

Não testamos esses limites, seria loucura! Estas são as especificações documentadas atuais da plataforma. Tenha-as em mente ao planejar seus redirecionamentos e priorize as principais URLs por tráfego e receita. Até onde sabemos, o Shopify não aumenta esses limites, apesar dos pedidos constantes nos fóruns de suporte.

O limite do Shopify para caracteres nas URLs

É aqui que as coisas ficam interessantes no sistema de redirecionamentos do Shopify. As diretrizes oficiais do Shopify não especificam limites rígidos de caracteres.

Para validar os limites de caracteres de URL de um redirecionamento, primeiro construímos e tentamos importar strings bem longas. Começamos com uma URL de 2.000 caracteres, já que os navegadores conseguem lidar com requisições de URI de até 2.083 caracteres. Aqui está a beldade em toda a sua glória:

/2000aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBcccccccccccccccccccccccccccccccccccccccccccccccccccDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNoooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

Nosso método inicial foi importar uma URL de 2.000 caracteres usando o modelo de redirecionamento em massa, e foi aí que os alarmes do Shopify dispararam. O patamar que descobrimos oficialmente foi um limite de 1.024 caracteres para strings de redirecionamento de URL, incluindo o prefixo de barra ‘/’.

• Passed URL de 300 caracteres
• Passed URL de 600 caracteres
• Passed URL de 1.000 caracteres
• Failed URL de 2.000 caracteres

Algumas regras de redirecionamento importantes e não documentadas para entender sobre o Shopify

O Shopify normaliza os caracteres alfabéticos nas suas strings de URL. Isso significa que, independentemente de você colocar uma letra maiúscula ou minúscula, ele vai atender a requisição de URL desses diferentes padrões da mesma forma. Todas as URLs a seguir vão para a mesma página, mesmo que existam registros individuais:

/CASE/TEST.html
/case/test.html
/Case/Test.html

A string em minúsculas terá prioridade sobre as demais:

/case/test.html

Nos nossos testes, mesmo havendo dois registros únicos de “Redirect from” com valores diferentes de “Redirect to”, a página /about.html sempre será servida para os dois registros:

#1
/Case/Test.html [redirect to] /homepage

#2
/case/test.html [redirect to] /about.html

É curioso e potencialmente irritante que o Shopify permita inserir todos esses valores únicos na tabela de redirecionamentos e sirva apenas um deles. Recomendamos revisar seus dados com cuidado se achar que a sua taxonomia de URLs pode cair nesses padrões antes de importar para o Shopify.

Você pode usar caminhos de URL absolutos nos redirecionamentos do Shopify

Caminhos de URL absolutos nos seus redirecionamentos são aceitáveis, segundo nosso teste, se estiverem no campo “Redirects to”. Eles podem apontar para qualquer URL que você quiser. Aqui está um exemplo em que um caminho de URL redireciona para um perfil do LinkedIn quando requisitado:

[Redirect from]
/Case/Test.html

[Redirect to]
https://www.linkedin.com/wislr

Além disso, no campo “Redirect to” o Shopify não remove domínios de topo, mesmo que seja o da sua própria loja Shopify.

URLs parametrizadas

Nos nossos testes, o Shopify preservou as URLs com parâmetros, com algumas exceções. Se você tem URLs que foram indexadas com muitas strings parametrizadas únicas, essas strings únicas podem ser adicionadas às tabelas de redirecionamento do Shopify e ir para destinos únicos. Fizemos esse teste com uma taxonomia comum para esse tipo de URL, os parâmetros UTM. Por exemplo:

Esta string de URL está no campo “Redirect from” da tabela de redirecionamentos e chegou ao destino pretendido:

/how-is-pkl?utm_campaign=301s+in+2024&utm_content=blue&utm_id=3012024&utm_medium=display&utm_source=google&utm_term=redirects

Modificamos a string de URL e removemos o último parâmetro ‘&utm_term=redirects’, o que gerou um 404:

/how-is-pkl?utm_campaign=301s+in+2024&utm_content=blue&utm_id=3012024&utm_medium=display&utm_source=google

Esse comportamento foi reproduzido em outros testes com parâmetros diferentes como valores, o que confirmou que o Shopify trata URLs parametrizadas como strings literais. Ele não reduz a URL até a URL base se você remover um parâmetro de uma URL de redirecionamento, desde que a URL não exista no site Shopify.

Para confirmar melhor isso, apontamos uma URL para ela mesma, o que por padrão o Shopify não permite. Você receberia esta mensagem:

Essa entrada é permitida quando os parâmetros estão no campo “Redirect from”. Ela não constitui um laço de redirecionamento, mas, pelo comportamento no navegador, nosso teste mostrou que o Shopify ignora esse registro. Quando a URL de “Redirect from” é requisitada, o Shopify serve a string de URL parametrizada completa, e não a página raiz como se esperaria pela tabela:

Essa entrada é permitida, mas o Shopify não vai anexar os parâmetros à página que carrega, como a regra prevê. Só a URL raiz será carregada.

Isso vale para caminhos de origem parametrizados. Onde o caminho de origem do redirecionamento não carrega parâmetros próprios, o que chegar na requisição é repassado ao destino:

GET /old-page              ->  301 to /new-page
GET /old-page?utm_source=x ->  301 to /new-page?utm_source=x

Os redirecionamentos não vão remover parâmetros por você. Removê-los precisa acontecer em uma camada acima do Shopify.

A correspondência também não é uma comparação literal de strings. O Shopify normaliza tanto o registro armazenado quanto a requisição de entrada antes de compará-los, então o uso de maiúsculas e a ordem dos parâmetros não importam. Contra um registro armazenado como /page?doe&name=john, todos os casos ?name=John&Doe, ?Doe&name=John e ?name=john&doe devolvem 301. O que importa é quais parâmetros estão presentes: cada parâmetro do caminho armazenado precisa aparecer na requisição, e retirar um devolve 404 em vez de uma correspondência parcial.

Nossa observação final sobre URLs com parâmetros é que o Shopify vai reescrever os dados que você fornece em alguns casos. Sim, o Shopify vai reescrever os dados de URL que você fornece para alguns parâmetros.

Aqui estão exemplos em que nossos testes encontraram esse padrão.

Dados de redirecionamento originais ingeridos pelo Shopify:

/test?name=John&Doe

O Shopify reescreveu a string para colocar ‘doe’ primeiro e passou para minúsculas:

/test?doe&name=john

Os valores são passados para minúsculas junto com as chaves, então uma tabela de redirecionamentos comparada com o arquivo de origem vai parecer que a importação corrompeu os dados.

Dados de redirecionamento originais ingeridos pelo Shopify:

/user?name=John&age=30&active=true

O Shopify reescreveu a string para dar uma nova ordem aos parâmetros listados:

/user?active=true&age=30&name=John

Os testes que rodamos sugerem que o Shopify tenta colocar os parâmetros em ordem alfabética. Nos perguntamos se isso seria um bug, já que determinamos que o Shopify trata URLs parametrizadas como strings literais, então por que minar essa regra reescrevendo a ordem dos parâmetros. Hoje, você nunca vai conseguir que strings de URL com múltiplos valores de parâmetro mantenham sua estrutura. Isso pode ter grandes implicações para alguns sistemas de gestão de conteúdo.

A experiência de uso dos redirecionamentos de URL do Shopify precisa de uma atualização

Durante o nosso uso extensivo da ferramenta de redirecionamentos do Shopify, acabamos gostando de alguns elementos e sentindo falta de outros.

Gostamos destes recursos:

• Botões e funcionalidade de importação de redirecionamentos em massa
• Filtro e busca rápida por taxonomia de URL
• Exportação de URLs
• Facilidade para criar uma URL única

Achamos que a ferramenta carece destes dados e funcionalidades:

• Contagem total de URLs importadas
• Uma forma mais fácil de copiar e colar mais de uma URL no sistema. Se você adiciona mais de uma URL por vez, precisa usar o documento de importação. Um caso de uso em que copiar e colar seria útil é quando um conjunto de URLs deve apontar todo para o mesmo destino.

Importar é rápido, desfazer uma importação não é

Criar redirecionamentos em massa é rápido. Removê-los em massa não é, e a diferença é grande o bastante para mudar como você planeja uma importação.

As mutações rápidas de exclusão em massa são restritas. urlRedirectBulkDeleteBySearch, urlRedirectBulkDeleteByIds e urlRedirectBulkDeleteAll exigem todas o escopo write_online_store_navigation e uma sessão de usuário ativa. Um app que se autentica com credenciais de cliente, que é como a maioria dos scripts de migração roda, não consegue chamá-las e fica apagando um registro de cada vez.

Planeje suas importações como se fossem difíceis de reverter, porque são. Valide o arquivo primeiro em uma loja de desenvolvimento, ou importe em blocos que você esteja disposto a desfazer à mão. Não empurre um arquivo de 50.000 linhas que você não testou supondo que dá para reverter rápido.

A importação CSV e a Admin API tratam duplicatas de formas diferentes

Este guia foi escrito em torno do fluxo com CSV, onde um caminho duplicado atualiza o registro existente. A API faz o oposto:

create /existing-path -> /pages/about
(where /existing-path already redirects to /)

REJECTED: "Path has already been taken"

Quem estiver portando um fluxo de CSV para a Admin API precisa consultar o registro existente e chamar urlRedirectUpdate, ou apagar e recriar. Um port direto da lógica de importação vai falhar em todo caminho que já existe.

Como testar seus redirecionamentos do Shopify depois do lançamento

Tudo acima descreve o que o Shopify vai aceitar. Nada disso diz se os redirecionamentos que você importou estão realmente funcionando na loja em produção, e essa é uma pergunta diferente. Um redirecionamento pode importar sem erros, aparecer no admin e ainda assim não fazer o que você esperava assim que um tema, um app ou um proxy entra no caminho.

Teste de fora da loja em vez de clicando por aí em um navegador, porque o navegador esconde justamente o que você precisa ver: o código de status. Requisite a URL antiga e leia os cabeçalhos da resposta.

curl -sIL https://yourstore.example/old-product-url

Leia três coisas na saída:

• O código de status no primeiro salto. Você quer 301. Um 302 é temporário e transfere valor de forma diferente, o que importa quando o objetivo todo é uma mudança permanente.
• O número de saltos. Cada linha HTTP/ na saída é um salto. Dois ou mais significa que você construiu uma cadeia, e a correção é reapontar a origem original para o destino final em vez de deixar o passo do meio no lugar.
• O status final. A última linha deve ser 200. Um redirecionamento que termina em 404 é pior do que nenhum redirecionamento, porque parece resolvido na sua planilha.

Depois teste os formatos que são fáceis de esquecer. Rode a mesma checagem em uma URL carregando um parâmetro de rastreamento para confirmar que a query string sobrevive até o destino, no domínio raiz além do www, e sobre http puro e não só https. Testamos exatamente isso em uma loja real e o parâmetro chegou intacto ao destino, mas o objetivo é verificar na sua loja em vez de confiar em uma resposta genérica, porque um tema ou um app podem mudar o resultado.

Um comportamento que vale conhecer antes de entrar em pânico: depois de alterar ou apagar um redirecionamento, um nó de borda do Shopify pode continuar servindo a resposta antiga por cerca de trinta segundos, enquanto uma versão da mesma URL com cache furado já devolve a nova. Dê um minuto e teste de novo com uma query string única no final antes de concluir que o redirecionamento não pegou.

Para a sequência completa em torno de uma migração, e não de um redirecionamento isolado, siga o checklist de migração de site, que cobre o mapeamento, o dia do lançamento e o monitoramento pós-lançamento em que isso se encaixa.

Conclusão

O sistema que o Shopify tem para gerenciar redirecionamentos 301 é bom para a maioria dos negócios, mas ainda não é de nível Enterprise. Com o tempo, esperamos que evolua para incluir redirecionamentos com curinga e mais registros de redirecionamento nos planos padrão e no Plus. A capacidade de usar o sistema de redirecionamentos deles e os vários tipos de formato de URL que ele suporta nos leva a dar uma nota de utilidade forte.

Se você está tocando um projeto que envolve mapeamentos complexos de redirecionamentos 301 e precisa de um time que vive e respira esse tipo específico de trabalho, fale conosco.

Changelog

Este guia foi publicado pela primeira vez a partir de testes de 19 de junho de 2024 e retestado em 27 de julho de 2026 contra uma loja Shopify real de plano padrão, pela Admin GraphQL API e por requisições reais à vitrine. A maior parte dos achados originais se manteve. Nove não. O corpo acima descreve o que o Shopify faz hoje, e aqui está o que mudou.

Os limites de registros, 100.000 nos planos padrão e 20.000.000 no Plus, não foram reexecutados. Alcançá-los é mecanicamente possível agora que o pipeline de importação está medido, mas a exclusão roda a cerca de 280 registros por minuto sem desfazer em massa por script, então confirmar um número documentado deixaria uma loja em produção carregando redirecionamentos inúteis por seis horas ou mais.

Perguntas frequentes

Para quem é a base de conhecimento da WISLR sobre redirecionamentos de URL no Shopify?

Nossa base de conhecimento ajuda principalmente marcas e agências que estão conduzindo migrações de site para o Shopify. Ela é especialmente valiosa para equipes pequenas que precisam aproveitar cada hora, ajudando os clientes a mapear e concluir até 100.000 redirecionamentos de URL com eficiência.

O Shopify tem um documento de suporte oficial para redirecionamentos de URL?

Sim, o Shopify mantém um documento de ajuda oficial sobre redirecionamentos de URL em help.shopify.com. Embora ele traga diretrizes gerais para adicionar redirecionamentos 301 individuais e em massa, o nosso guia o complementa com especificações detalhadas sobre tipos de URL e limites da plataforma.

Quais strings de URL o Shopify não suporta?

O Shopify tem apenas um formato de string de URL não suportado: strings com um caractere de ponto e vírgula sem codificar depois do operador de igual (por exemplo, /page?param=;semicolon). Todos os outros formatos de URL, incluindo pontos e vírgulas codificados e pontos e vírgulas em outras posições, são suportados.

O Shopify suporta redirecionamentos com curingas ou regex?

Não, o Shopify hoje não suporta redirecionamentos com curinga nem padrões regex no seu sistema nativo de redirecionamentos. Essa limitação vale tanto para as lojas Shopify padrão quanto para as Shopify Plus.

O que são redirecionamentos com curinga?

Redirecionamentos com curinga permitem redirecionar várias URLs que coincidem com um padrão específico para um único destino. Por exemplo, redirecionar todas as URLs sob /blog/* para /articles/*. Embora seja um recurso muito pedido, ele não está disponível hoje na funcionalidade nativa do Shopify.

O Shopify consegue evitar a criação de cadeias de redirecionamento?

Sim, o Shopify tem proteções embutidas para evitar cadeias de redirecionamento. O sistema não permite criar um redirecionamento para uma URL que já está sendo redirecionada para outro lugar.

O que são cadeias de redirecionamento?

Cadeias de redirecionamento acontecem quando as URLs redirecionam por vários passos antes de chegar ao destino final (por exemplo, A→B→C). Essas cadeias podem deixar o carregamento das páginas mais lento e prejudicar o desempenho de SEO. O sistema do Shopify ajuda a evitá-las por design.

É fácil criar e atualizar redirecionamentos de URL no Shopify?

Sim, o Shopify oferece dois métodos simples: a criação de redirecionamentos de URL individuais pela interface e a importação em massa por arquivo CSV. Os dois métodos suportam caminhos de URL relativos e absolutos.

Como criar redirecionamentos de URL em massa no Shopify?

Redirecionamentos em massa podem ser criados com a ferramenta de importação CSV do Shopify. Recomendamos importar em lotes de 1.000 para facilitar a verificação de erros e a gestão. Um modelo para a importação está disponível aqui.

O Shopify tem um limite máximo de registros de redirecionamento de URL?

Sim. Os planos padrão do Shopify são limitados a 100.000 redirecionamentos de URL, enquanto as lojas Shopify Plus conseguem armazenar até 20.000.000 de redirecionamentos. Esses limites são fixos e não podem ser aumentados.

O Shopify tem limites de contagem de caracteres nos redirecionamentos?

Sim, o Shopify impõe um limite de 1.024 caracteres para as strings de redirecionamento de URL, incluindo a barra inicial (’/’). URLs que passarem desse comprimento não serão aceitas pelo sistema.

Existe alguma ferramenta para validar URLs compatíveis com o Shopify?

Embora o Shopify não ofereça uma ferramenta de validação oficial, nossos testes abrangentes mostraram que 99% dos formatos de URL padrão são suportados. O ponto principal a considerar é o limite de 1.024 caracteres e evitar pontos e vírgulas sem codificar depois de operadores de igual.