Estrutura de pastas do CMS

Layout

Algumas pastas do CMS são obrigatórias. Se sua loja não tiver essas pastas - com os nomes exatamente iguais aos que indicamos neste artigo - você terá problemas de navegação e indexação.

Outras pastas são recomendadas, por serem úteis à maioria das lojas.

Neste artigo falaremos sobre todas essas pastas.

Pastas obrigatórias

Estas são as pastas que toda loja precisa ter no CMS para garantir o correto funcionamento da navegação e da indexação:

Busca
Categoria
Departamento
Login
Produto

Veja abaixo estas pastas básicas no CMS:

${"base64":" ","img":{"width":200,"height":321,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":14150,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Storefront/Layout/estrutura-de-pastas-do-cms_1.png"}}$

Estas pastas vêm por padrão no ambiente de todas as lojas VTEX.

Os nomes das pastas obrigatórias não devem ser editados. Isso pode comprometer o funcionamento correto da loja e impedir que compras sejam realizadas.

Como as pastas se referem a páginas dinâmicas, seus nomes não aparecem na navegação do cliente. Ou seja, o fato de a edição dos nomes ser vetada não afeta o texto final das suas URLs nem, portanto, a internacionalização do seu site.

Os nomes dos layouts podem ser editados sem nenhum problema.

Pastas importantes

Algumas pastas do CMS não são obrigatórias mas são úteis. Por isso, recomendamos que você não as exclua.

São elas:

/account: conta do cliente.
/account/orders: pedidos do cliente.

Para estas duas pastas, o que importa é o controle ou placeholder que lê o conteúdo delas. Os nomes delas podem ser livremente editados.

Como são pastas privadas, /account e /account/orders precisam requerer autenticação. Veja neste artigo como garantir que elas estejam configuradas para pedir autenticação do usuário.

Pastas úteis

Há pastas que, embora não sejam tão importantes quanto as anteriores, costumam ser úteis para grande parte das lojas. São elas:

/sistema/buscavazia: pasta para onde o usuário é direcionado caso a busca não encontre resultados.
/sistema/{codigoHTTP}: pasta que renderiza páginas de erros de acordo com os códigos de status HTTP, tais como 404 (página não encontrada), 401 (não autorizado) e 500 (erro de servidor).
/sistema/marcas: pasta que contém layouts de páginas de marcas, que podem ser customizadas com um layout exclusivo. Se não houver layout específico para marcas, essas páginas serão renderizadas da mesma forma que a pasta de busca. Para entender como funcionam páginas de marca, veja o artigo sobre a busca da VTEX.