> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Compatibilidade de temas com o Upcart

> Este artigo descreve como solucionar problemas de compatibilidade de temas com o Upcart e apresenta as melhores práticas para um desempenho ideal.

<div id="overview">
  ## Visão geral
</div>

O Upcart foi projetado para se integrar perfeitamente à maioria dos **temas criados pelo Shopify**. No entanto, alguns temas de terceiros podem causar problemas de funcionalidade devido a diferenças na estrutura do código e na personalização.

Os temas nativos do Shopify são desenvolvidos pelo próprio Shopify, garantindo compatibilidade total, enquanto temas personalizados ou de terceiros podem causar problemas, mesmo que tenham sido comprados pela plataforma do Shopify.

Recomendamos usar os **temas integrados do Shopify**, como o **Dawn**, que oferecem a melhor compatibilidade e desempenho com o Upcart. Nossa equipe tem um escopo limitado de suporte para temas de terceiros, pois variações na forma como eles são desenvolvidos podem levar a conflitos que estão fora do nosso controle.

Para esclarecer, temas como FOXECOM, mesmo comprados no Shopify, são categorizados como de terceiros e podem ter certas limitações de funcionalidade.

***

<div id="incompatible-themes">
  ## Temas incompatíveis
</div>

Os seguintes temas causam problemas de forma consistente com o Upcart e não são suportados:

* **Trade**

Se você estiver usando este tema e tiver problemas com o Upcart, recomendamos mudar para um tema criado pelo Shopify mais compatível para garantir a funcionalidade completa.

***

<div id="themes-that-may-cause-issues">
  ## Temas que podem causar problemas
</div>

Os seguintes temas foram relatados como causadores de conflitos ou podem não funcionar totalmente como esperado com o Upcart:

* **Shrine**
* **Impulse**
* **Impact**
* **Prestige**

Embora esses temas possam funcionar em alguns casos, certos elementos ou recursos do Upcart podem não ser exibidos ou funcionar como esperado. Se você tiver problemas ao usar qualquer um desses temas, recomendamos testar com o **Dawn** ou outro tema criado pelo Shopify para obter os melhores resultados.

Para temas com desafios de compatibilidade, os desenvolvedores podem utilizar a [API pública do Upcart](https://rokt.notion.site/upcart-public-api) para trabalhar em uma solução.

Nota

Os temas listados são exemplos de temas que apresentaram possíveis problemas de compatibilidade com o Upcart. Pode haver outros temas ainda não identificados. Esta lista será atualizada à medida que novos casos forem encontrados ou relatados.

***

<div id="partially-supported-themes">
  ## Temas parcialmente suportados
</div>

Muitos temas do Shopify são compatíveis com o Upcart, e trabalhamos para tornar o app o mais acessível possível para lojistas que usam temas personalizados ou não padrão.

Se você suspeitar que seu tema é apenas parcialmente suportado:

Isso pode incluir contratar um Shopify expert para usar a API do Upcart, garantir que elementos padrão do Shopify sejam usados ou considerar a mudança para um tema nativo do Shopify para eliminar os desafios de compatibilidade.

1. Revise primeiro os seguintes artigos:

* [**Alterar o tipo de carrinho no tema**](/pt/upcart/change_cart_type_in_theme)

- **Código de tema malformado**

2. Se os problemas persistirem após seguir essas etapas, entre em contato com o **Suporte do Upcart** para obter mais assistência.
3. Forneça ao desenvolvedor do tema acesso à [API pública do UpCart](https://rokt.notion.site/upcart-public-api) para resolver os problemas de compatibilidade do tema de forma eficaz.

***

<div id="testing-recommendation">
  ## Recomendação de testes
</div>

Antes de colocar qualquer alteração no ar, recomendamos **testar o Upcart em uma pré-visualização de tema** ou em uma **versão duplicada** do seu tema. Isso permite verificar se todos os recursos de carrinho e upsell funcionam corretamente sem afetar sua loja ao vivo.

Para fazer isso:

1. No seu admin do Shopify, vá em **Online Store > Themes**.
2. Clique em **Actions** ao lado do seu tema ativo e selecione **Duplicate**.
3. Abra o tema duplicado e clique em **Preview**.
4. Teste sua configuração do Upcart, incluindo interações do carrinho, descontos e upsells.
5. Depois de confirmar, publique o tema atualizado.

Testar com antecedência garante a compatibilidade e ajuda a evitar problemas de exibição ou desempenho antes que eles afetem seus clientes.

***

<div id="best-practices">
  ## Melhores práticas
</div>

Para manter o melhor desempenho e garantir que o Upcart funcione perfeitamente com seu tema:

* **Mantenha seu tema atualizado.** O Shopify e os desenvolvedores de temas lançam regularmente atualizações que melhoram a compatibilidade e o desempenho.
* **Teste após qualquer edição no tema.** Se você fizer alterações de código ou layout, teste o comportamento do carrinho para garantir que tudo seja exibido corretamente.
* **Evite personalizações pesadas de terceiros.** Grandes modificações de design ou scripts podem interferir na funcionalidade do carrinho.
* **Use o Theme Editor do Shopify com cuidado.** Pré-visualize as alterações antes de publicar para evitar problemas de exibição ou de checkout.

Seguir essas melhores práticas ajuda a manter uma configuração estável e garante que sua loja funcione perfeitamente com o Upcart.