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

# Solução de problemas

> Onde procurar quando o tema não valida, o editor não mostra a seção ou os dados vêm vazios.

Use esta página como índice. O detalhe de cada falha está no guia ligado.

| Sintoma | Onde ler |
| - | - |
| `corvex validate` ou `corvex build` falha | [CLI](https://docs-loja.usecorvex.com.br/cli/commands.md) e [Contrato do tema](https://docs-loja.usecorvex.com.br/reference/contracts/theme.md) |
| Campo não aparece no inspetor | [Schema](https://docs-loja.usecorvex.com.br/schema/overview.md) — o `id` do setting precisa ser o mesmo lido em `settings` |
| Seção some ou blocos não arrastam no editor | [Runtime API](https://docs-loja.usecorvex.com.br/reference/runtime-api.md) e [Compatibilidade do iframe](https://docs-loja.usecorvex.com.br/guides/editor-iframe-compatibility.md) |
| Tokens do tema em `:root` ou seletor global dentro do canvas | [Escopo de CSS](https://docs-loja.usecorvex.com.br/themes/css-scoping.md). O iframe isola o canvas da barra do editor |
| Produtos, carrinho ou página vazios | [Armadilhas de dados](https://docs-loja.usecorvex.com.br/data/pitfalls.md) e [Regras de escopo](https://docs-loja.usecorvex.com.br/data/scope-rules.md) |
| Slides ou banners somem depois do primeiro bloco | [Defaults do tema](https://docs-loja.usecorvex.com.br/guides/theme-defaults.md) |
| Inspector sem lista Itens, ou campos de outro block | [Section Contract — erros](https://docs-loja.usecorvex.com.br/reference/contracts/section.md#erros) — não declare propriedade estática no componente |
| Canvas em branco depois de mudar a pasta da seção | [Identidade](https://docs-loja.usecorvex.com.br/reference/contracts/section.md#identidade-type-estável-name-livre) — não mude a pasta; `name` pode mudar |
| Recarregar mostra banners de fábrica; clicar no bloco mostra os do lojista | [Section Contract — erros](https://docs-loja.usecorvex.com.br/reference/contracts/section.md#erros) e [Defaults do tema](https://docs-loja.usecorvex.com.br/guides/theme-defaults.md) |
| Vídeo não reproduz ou pesa a página | [FAQ de vídeo](https://docs-loja.usecorvex.com.br/guides/video-faq.md) |

Confirme `manifestVersion: 2` e pastas `sections/{id}/schema.json`.

Perguntas já respondidas nos exemplos: [Cookbooks](https://docs-loja.usecorvex.com.br/cookbook/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.