Documentação / Videocommerce / Boas práticas e problemas

Como preparar os vídeos para uma vitrine rápida e uniforme — e o que verificar quando algo não aparece como esperado.

Boas práticas e performance

• Otimize os vídeos antes de subir. Prefira MP4 curtos, sem áudio (o catálogo é sempre mudo), com dimensão padronizada por posição — quadrado ou 4:5 no catálogo, 9:16 nos stories. Vídeos menores carregam mais rápido e uniformizam a vitrine.
• Use a imagem destacada como capa. Ela cobre o espaço enquanto o vídeo carrega e serve de reserva se o vídeo falhar.
• O carregamento sob demanda já é automático. O plugin só baixa o vídeo quando ele entra na tela — não é preciso configurar nada.
• Ative métricas quando for usar. Se não for acompanhar os números, deixe desligado.

Compatibilidade

• Flatsome — integração testada, incluindo os seletores de variação nativos nos stories shoppable.
• FunnelKit Cart — o carrinho lateral abre automaticamente ao adicionar pelo vídeo.
• WP Rocket / Cloudflare — o plugin convive com otimizadores de CSS/JS e cache; os estilos essenciais resistem à combinação e remoção de CSS.
• GIF — aceito e tratado como imagem animada (sem controles de vídeo).

Solução de problemas

O botão “Comprar / Ver opções” aparece sobre o vídeo no catálogo

Em alguns temas (como o Flatsome), o botão de compra é posicionado sobre a imagem do produto — a mesma área onde o vídeo entra, então ele pode reaparecer mesmo desativado no tema. Solução: em Configurações, ative “Ocultar botão de compra no catálogo” e salve. Se ainda assim o botão aparecer em algum tema específico, fale com a equipe da Pixel Partners informando o tema e a versão.

O vídeo não aparece no catálogo ou na página do produto

Verifique, em ordem:

• O produto tem vídeo associado no bloco “Vídeo de capa do produto”?
• O recurso está ligado em Configurações (catálogo e/ou página do produto)?
• O controle por produto não está definido como “Não”?
• O formato do arquivo é MP4, WebM ou GIF?

Os tamanhos no story não aparecem como esperado

Os seletores de variação são renderizados pelo próprio tema. Se não estiverem no formato de botões, aparecem como seleção nativa — funcional do mesmo jeito. Verifique a configuração de swatches do tema para o atributo em questão.

O carrinho lateral não abre ao adicionar pelo vídeo

O carrinho lateral depende do tema ou plugin de carrinho (ex.: FunnelKit). Sem ele, o produto é adicionado normalmente e o botão confirma “Adicionado ✓” — só o painel lateral que pode não abrir.

Documentação do Videocommerce · escrita com base na versão 1.6.2. As telas ilustradas podem variar conforme a versão instalada na sua loja.