ℹ️ Note: Este artigo foi traduzido automaticamente utilizando IA e pode conter imprecisões. Se algo parecer errado, entre em contato com nossa equipe de suporte.

A Upsell & Cross Sell widget geralmente começa a aparecer logo após você publicar seu primeiro upsell — mas às vezes uma pequena configuração, regra de visibilidade ou configuração relacionada ao tema pode impedir que ele apareça na frente do store.

A boa notícia é que estas questões são geralmente muito rápidas para corrigir 🚀

Este guia caminha através das razões mais comuns por que o seu Upsell & Cross Sell bloco pode não aparecer e como resolver cada passo a passo.

Na maioria dos casos, a questão está relacionada a um dos seguintes:

• A App Inbed está desabilitada
• A configuração não foi salva
• A configuração não foi publicada
• Tipo de colocação errado para a página que você está testando
• Bloco de posição personalizado não adicionado ao tema
• Condições de exibição (história da ordem, valor do carrinho, clientes pela primeira vez)
• Configurações de segmentação do cliente
• Restrições de orientação geográfica
• Upsell produtos não estão disponíveis ou fora de estoque
• Conflitos de temas
• Navegador ou cache de armazenamento

Vamos passar por eles um por um. 👇

✅ Passo 1: Verifique se a incorporação da aplicação está habilitada

Pela Upsell & Cross Sell widget para aparecer em seu storefront, o aplicativo embed deve ser ativado dentro de seu Shopify tema. Sem ele, o script widget nunca carrega em sua loja — mesmo que tudo o mais esteja configurado perfeitamente.

Ir para:

Shopify Admin → Canais de Vendas → Loja online → Temas → Editar tema → App Incorpora

Depois:

• Procurar "Upsell Cross-Sell Slider"
• Activar
• Clique Gravar

💡 Dica: Se já estiver habilitado, tente fechar o Editor de Temas e reabri-lo, e então deslige a aplicação Incorporar e ligar novamente, e clique em Gravar Mais uma vez.

ℹ️ O aplicativo também verifica isso para você. No painel de aplicação, o Guia de Configuração mostra uma "Ativar incorporação de aplicativos" passo — fica verde uma vez que a incorporação é detectada como ativa em seu tema ao vivo.

✅ Passo 2: Salvar a Configuração

Ao criar um novo upsell, sua configuração não é armazenada até você clicar Gravar na barra de gravação no topo da página de configuração.

Se você fechou a aba sem salvar, o upsell nunca foi criado — então não há nada para o storefront exibir.

Abra sua configuração Upsell → faça suas alterações → Clique Gravar

✅ Passo 3: Publicar a Configuração

Mesmo que seu Upsell esteja totalmente configurado e salvo, os clientes não o verão até que a configuração tenha sido publicado.

Abra sua configuração Upsell → Clique Publicar no topo da página.

Você pode confirmar o status do crachá ao lado do nome da configuração:

• Publicado → viver em sua loja ✅
• Não publicado → escondido dos clientes

Você também pode publicar ou criar configurações diretamente da tabela do painel usando as ações em massa.

⚠️ Salvar sozinho não faz o Upsell viver. Ambas as acções são necessárias — Gravar Primeiro, então... Publicar.

✅ Passo 4: Certifique-se de que você está testando a página certa

Cada configuração upsell está ligada a um tipo de colocação específico, e o widget só aparece na página correspondente:

• Página do produto → mostra abaixo o botão Adicionar ao Carrinho nas páginas do produto
• Página do Carrinho → mostra no /cart página
• Gaveta de Carrinhos → mostra dentro da gaveta do carrinho
• Posição Personalizada → mostra onde quer que você coloque o bloco do aplicativo em seu tema

Exemplo: Se você criou um Página do Carrinho upsell, ele nunca aparecerá em uma página de produto — não importa quantas vezes você refresque. Abra a página do carrinho da sua loja e verifique lá.

💡 Para o Cart Gawer upsells, o widget é injetado quando a gaveta abre. Adicione um produto ao carrinho e abra a gaveta para testá-lo.

✅ Passo 5: Usando a posição personalizada? Verificar o Bloco da Aplicação

Se a sua configuração usar o Posição personalizada colocação, o widget não aparece automaticamente — ele renderiza apenas onde você colocou o bloco Upsell em seu tema.

Abra sua configuração Upsell → Colocação tab → Mostrar Ligado (Incluir) → certifique-se Posição personalizada é selecionado, então:

1. Copiar a Upsell ID mostrado dentro da configuração (ou da legenda da página no topo)
2. Ir para Shopify Editor de Temas → Adicionar Secção / Adicionar Bloco → Guia Apps → Upsell Cross-Vell Block
3. Colar o Upsell ID nas configurações do bloco
4. Clique Gravar

Alternativamente, você pode colocar o trecho de código fornecido em um Liquido Personalizado seção ou diretamente em seu código de tema.

⚠️ Posição personalizada em que funciona actualmente páginas de produto e páginas de carrinho Apenas. O bloco ficará vazio em outras páginas, e também ficará vazio se o Upsell ID colado no bloco não corresponder exatamente à configuração.

📖 Precisa de ajuda para localizar a identificação? Ver: 🔎 Como encontrar Upsell ID?

✅ Passo 6: Verificar as Regras de Exibição (Incluir) e Excluir

Dentro da Colocação tab, o Mostrar Ligado (Incluir) definindo controles em que produtos o widget aparece.

Abra sua configuração Upsell → Colocação tab → Mostrar Ligado (Incluir)

Em seguida, verifique:

• Se Produtos específicos é selecionado → o widget só mostra nessas páginas exatas do produto
• Se Todos os produtos em coleções específicas é selecionado → o produto que você está vendo deve pertencer a uma das coleções selecionadas
• Se Todos os produtos com etiquetas específicas é selecionado → o produto deve carregar uma das etiquetas inseridas

Mesmo abaixo dele, verifique o Não exibir Ligado (Excluir) seção também — você pode ter excluído o produto exato ou coleção que você está testando.

Exemplo: Se o widget aparecer em algumas páginas de produto, mas não em outras, as páginas que faltam são quase sempre capturadas por uma regra de inclusão ou exclusão aqui.

✅ Passo 7: Verifique as Condições de "Exibir somente quando"

A Mostrar apenas quando a seção adiciona condições que devem ser verdadeiras antes do widget aparecer.

Abra sua configuração Upsell → Colocação tab → Mostrar apenas quando

Verificar se algum destes está habilitado:

• Número mínimo de pedidos → escondido até que o cliente tenha colocado que muitos pedidos
• Mostrar uma vez por cliente → escondido de qualquer um que já tenha pedido
• O valor do carrinho está abaixo (valor máximo do carrinho) → escondido uma vez que o total do carrinho vai acima da quantidade que você definir
• A última encomenda foi há mais de X dias → mostrado apenas a clientes cuja última encomenda é mais antiga do que o período definido
• A última ordem foi nos últimos X dias → mostrado apenas aos clientes que encomendaram recentemente

Exemplo: Se O valor do carrinho está abaixo de $50 está habilitado e seu carrinho de teste já contém $80 de produtos, o widget permanece escondido por design.

💡 Para efeitos de ensaio, seleccionar Mostrar Sempre — isto substitui todas as outras condições e ajuda a confirmar se estas definições estão a causar o problema de visibilidade.

📖 Para uma análise completa de cada condição de alvo, ver: 🎯 Opções de Alvo Avançadas para Upsell & Cross Sell

👥 Passo 8: Verifique as configurações de destino do cliente

Se Segmentação do cliente está configurado, o widget pode permanecer oculto para certos visitantes ou grupos de clientes.

Abra sua configuração Upsell → Colocação tab → Segmentação do cliente

Verifique o seguinte:

• Visibilidade (Status de login do cliente) → se definido para Apenas os clientes logados, visitantes que não estão logados não verão o widget (e vice-versa para Apenas clientes de saída)
• Visualização do Cliente → se definido para Clientes com etiqueta específica ou Clientes com montante específico gasto, apenas clientes correspondentes irão vê-lo
• Ocultar cliente → os clientes com a etiqueta selecionada ou o valor de despesa são explicitamente excluídos

⚠️ Exemplo: Se o widget estiver configurado para mostrar apenas para clientes marcados como VIP, em seguida, clientes regulares sem VIP Tag não vai vê-lo. Tags de clientes e histórico de pedidos também só funcionam para Clientes registados — os visitantes logados são tratados como sem etiquetas e sem encomendas.

💡 Para efeitos de ensaio, recomenda-se que:

→ Visibilidade → Todos os visitantes → Display do cliente → Todos os clientes → Ocultar cliente → Nenhum

Isso ajuda a confirmar se o alvo do cliente está causando o problema de visibilidade.

✅ Etapa 9: Verificar a Meta de Geolocalização

Se a Meta de Geolocalização estiver habilitada, o widget só poderá aparecer em países ou regiões selecionados.

Abra sua configuração Upsell → Colocação tab → Objectivo da geolocalização

Se Países específicos é selecionado, verifique se seu país está incluído na lista permitida.

Exemplo: Se apenas Estados Unidos está selecionado e você está navegando da Índia, o widget não será visível para você a menos que você use uma VPN.

💡 Dica: O país detectado é lembrado durante a sua sessão de navegação. Se você mudou de país ou ligou/desligar VPN no meio da sessão, feche a aba completamente e abra a loja novamente em uma sessão nova antes de testar.

✅ Passo 10: Verifique os produtos Upsell

Às vezes o widget carrega corretamente, mas não tem nada para exibir — nesse caso ele se esconde automaticamente.

Abra sua configuração Upsell → Conteúdo tab → Selecione produtos upsell

Em seguida, verifique:

• Upsell Produtos específicos / Upsell Colecções específicas → pelo menos um produto ou coleção é realmente selecionado
• Os produtos selecionados (ou os produtos dentro das coleções selecionadas) são em stock e disponível — o elemento indica apenas os produtos que podem ser adquiridos
• Upsell mesmo produto (Como na página do produto) → este tipo só funciona em páginas de produto, uma vez que precisa de um "produto atual" para exibir
• AI Upsell (Comprados Freqüentemente Juntos) → funciona melhor quando produtos relacionados ou complementares são configurados em ShopifyPesquisa & Discovery app; caso contrário, ele cai de volta para produtos aleatórios da sua loja

Exemplo: Se todas as variantes do seu produto upsell selecionado estão fora de estoque, o widget inteiro permanece escondido até que pelo menos um produto fique disponível novamente.

✅ Passo 11: Verifique o Atraso do Tempo no Site

O widget pode ser configurado para aparecer apenas após o visitante ter passado algum tempo na página.

Abra sua configuração Upsell → Colocação tab → Segmentação no local

Se Mostrar depois de algum tempo está selecionado, o widget só aparecerá após o número configurado de segundos (até 300).

Isto não é um erro — mas durante o teste pode parecer que o widget está faltando. Aguarde que o atraso passe, ou mude temporariamente para Mostrar sempre (Padrão).

✅ Passo 12: Atualizar Difícil Sua Página

Às vezes Shopify ou seu navegador armazena temporariamente os ativos do storefront, incluindo a configuração de upsell publicada.

Uma atualização dura geralmente corrige isso instantaneamente.

Janelas

Ctrl + Shift + R

Mac

Cmd + Shift + R

Isso força o navegador a recarregar os ativos mais recentes do storefront em vez de usar versões em cache.

ℹ️ Nota: As configurações publicadas podem levar alguns minutos para chegar ao storefront. Se você acabou de publicar, espere um momento e depois se refresque.

✅ Passo 13: Verifique na janela do Incógnito

Certas condições de visibilidade podem se comportar de forma diferente para os visitantes que retornam.

Por exemplo:

• Cache temporário existente
• Dados de localização ou sessão recordados
• Ser conectado como cliente (ou não)

todos podem mudar se o widget aparece.

Tente:

• Abrindo sua loja em Modo Incógnito
• Usando outro navegador
• Ensaio noutro dispositivo

Isso ajuda a confirmar se o problema está relacionado ao cache/sessão — e se suas configurações de segmentação o tratam de forma diferente de um novo visitante.

✅ Passo 14: Verifique se o tema Styling conflitos

Em alguns casos, o widget está realmente carregando corretamente — mas o estilo do tema pode estar escondendo visualmente.

Isto geralmente acontece devido a:

• CSS personalizado de outros aplicativos
• Substituição do tema
• Estilo agressivo de construtores de páginas ou aplicativos de animação
• Temas fortemente personalizados onde o ponto de colocação automático não existe

Abrir o Desenho aba dentro do aplicativo e alterar temporariamente:

• Cor de fundo
• Cor do texto
• Cor do botão

Então... Gravar muda e atualiza o storefront.

Se suas mudanças de estilo ainda não aparecerem, seu tema pode não ter os elementos de colocação padrão que o aplicativo procura (por exemplo, um formulário padrão Adicionar ao Carrinho ou recipiente de carrinho). Nesse caso:

• Mudar a colocação para Posição personalizada e coloque o widget exatamente onde você quer usando o bloco app (ver Passo 5)
• Ou contate sua equipe de suporte ao desenvolvedor / tema

Uma nota rápida sobre o direcionamento da fonte de tráfego (UTM)

Se você tiver usado outro Hoppy apps, você pode estar procurando restrições UTM ou de origem de tráfego. A versão atual de Upsell & Cross Sell faz não incluir segmentação baseada em UTM — então a fonte de tráfego nunca pode ser a razão pela qual seu widget está escondido.

Ainda não apareceu?

Se você tentou todos os passos acima e o Upsell & Cross Sell widget ainda não está visível:

1. Gravar novamente a configuração
2. Publicar novamente
3. Reinicie o aplicativo Incorpore e salve o tema
4. Teste em uma página de produto ao vivo (e a página do carrinho / gaveta do carrinho, dependendo do seu tipo de colocação)
5. Teste em Modo Incógnito com Mostrar Sempre habilitado

Se o problema continuar, não hesite em contactar-nos diretamente de dentro do Hoppy Upsell & Cross Sell app — basta clicar Suporte de Contato no painel ou dentro de qualquer página de configuração.

Para nos ajudar a solucionar problemas mais rápido, por favor inclua:

• Guardar o URL
• Tipo de colocação (Página do produto / Cart Page / Cart Gaveta / Posição personalizada)
• Imagem da sua configuração
• URL da página onde o elemento deverá aparecer
• Nome do tema

Ficaremos felizes em ajudar. 🙌

Actualizado em: 15/09/2026