---
title: Solucionar problemas de compilações de vitrine
description: Diagnostique uma visualização de vitrine em branco, desatualizada, quebrada ou visualmente incorreta antes de publicá-la.
---

A visualização é o lugar mais seguro para encontrar problemas de vitrine. Não publique até que as páginas e interações importantes funcionem lá.

**Caminho de entrada:** Documentação do Runner → **Ajuda e referência** → **Solucionar problemas de compilações de vitrine**.

## Antes de começar

- Abra a loja afetada e identifique a página e a largura do dispositivo onde o problema aparece.
- Deixe a tarefa mais recente do Runner terminar antes de comparar seu resultado com a Visualização.
- Use a Visualização primeiro; não publique um resultado quebrado ou incerto como teste.

## Comece na Vitrine

1. Abra a loja afetada e selecione **Vitrine**.
2. Confirme que a visualização está mostrando o projeto esperado e a versão mais recente.
3. Recarregue a visualização uma vez.
4. Verifique as visualizações de dispositivos desktop e móvel.
5. Abra a página afetada através da navegação de visualização.
6. Compare o resultado com a tarefa mais recente do Runner e o histórico de versões.

## Problemas comuns

| O que você vê | O que verificar |
| --- | --- |
| Visualização em branco ou com erro | Aguarde a compilação ativa terminar, recarregue uma vez e inspecione a tarefa atual para uma falha. |
| Conteúdo antigo | Confirme que a tarefa mais recente foi concluída e que a visualização está na versão mais recente. |
| Layout quebra em uma largura | Reproduza com os controles de dispositivo e diga ao Runner a página, seção e largura. |
| Imagem ausente | Verifique a Biblioteca de Mídia, a seleção de ativo e se a imagem em si carrega. |
| Link abre a página errada | Nomeie o botão de origem e o destino pretendido em uma correção focada. |
| Produto está ausente | Verifique se o produto existe e está disponível para a vitrine, não apenas se a página parece polida. |
| Alteração do Modo de Design está ausente | Confirme que a edição foi salva ou aplicada e reabra a mesma página na visualização. |

## Controles úteis

| Controle | Resultado |
| --- | --- |
| Atualizar visualização | Recarrega a visualização atual sem publicá-la. |
| Seletor de dispositivo | Altera a largura da visualização para que você possa inspecionar layouts responsivos. |
| Abrir visualização ou visualização externa | Abre uma visualização maior; não torna a loja ativa. |
| Modo de Design | Permite selecionar e ajustar conteúdo de vitrine visível. |
| Histórico de versões | Mostra versões salvas e controles de restauração. A restauração altera o estado do projeto, portanto, revise primeiro. |

## Escale com evidência útil

Inclua o nome do projeto, página, tamanho do dispositivo, resultado esperado, resultado visível, estado da tarefa mais recente e uma captura de tela sem dados pessoais ou de clientes.

## Guias relacionados

- [Visualizar sua loja](../storefront-and-publishing/preview-your-store)
- [Modo de Design](../storefront-and-publishing/design-mode)
- [Histórico de versões](../storefront-and-publishing/version-history)
- [Solucionar problemas de tarefas do Runner](./troubleshoot-runner-tasks)