Validação e publicação

Use este checklist após criar pelo editor, sincronizar pelo Build Kit ou enviar pela API.

1. Valide o cadastro

Nome interno em snake_case.
Tipo correto e imutável para o uso desejado.
Schema válido com title, description, settings e content, quando o tipo usa schema; settings_mobile e content_mobile quando houver configuração mobile própria.
Um arquivo principal por tipo de arquivo utilizado.
Auxiliares existentes, sem duplicidade ou ciclos.
Contratos específicos preservados para header, footer, product block, buttons e icons.
SCSS escrito na escala correta (1rem = 10px) e usando .image, .video e .lazy quando aplicável. Consulte Base de estilos.

2. Selecione e configure

Criar ou sincronizar não torna o componente visível automaticamente. Selecione-o pelo título na área compatível, preencha seu conteúdo e configurações e salve a configuração da loja.

Componentes globais precisam ser ativados em Componentes globais.

3. Confira o resultado

Cenário	O que verificar
Seção	Ordem, conteúdo, imagens, links e fallback mobile.
Header	Logo, menu, busca, conta, carrinho, busca reativa e menu mobile quando usados.
Footer	Menu, links, newsletter, pagamento e submenu mobile.
Product block	Produto disponível, promoção, Pix, parcelas, indisponibilidade e atualização de preço.
Global	Resultado em páginas diferentes, sem depender de ordem fixa.
Buttons	Estados normais, foco, loading e indisponibilidade.
Icons	Todos os locais que usam símbolos SVG.

Repita a verificação em desktop e mobile. Prévia visual, salvamento bem-sucedido ou resposta de criação não substituem esse teste.

Ciclo de vida do componente

Estado	Comportamento
Ativo	Pode ser selecionado e configurado na área compatível.
Inativo, sem uso	Continua editável e pode ser reativado, mas não pode ser escolhido novamente.
Inativo, ainda usado	A configuração existente pode continuar disponível para edição, mas a publicação é bloqueada até reativar o componente ou remover todas as referências.
Exclusão solicitada com uso atual ou edição pendente	A exclusão retorna `409`; remova seleções e edições pendentes antes de tentar novamente.
Exclusão concluída	O componente deixa o catálogo e não pode permanecer em uma configuração válida da loja.

Não há recuperação automática para uma configuração antiga ou inválida. Identifique o componente indicado na falha, reative-o ou retire suas referências e só então publique ou exclua.

4. Publique

Publique somente depois de validar o resultado. Se o componente estiver inativo ou ainda referenciado, reative-o ou ajuste a seleção antes de publicar.

Como interpretar falhas

Situação	Próxima ação
Não salva	Corrija schema, arquivos ou contrato do tipo.
Salva, mas não aparece	Selecione-o na área compatível e salve a configuração.
Aparece diferente do esperado	Revise Liquid, SCSS, JavaScript e o teste desktop/mobile.
Não pode ser excluído	Remova a seleção e quaisquer edições pendentes que ainda o referenciem.

Veja Troubleshooting para correções detalhadas.