Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Storefront
Layout
CMS folder structure
CMS folder structure

Some CMS folders are required. If your store does not have these folders - with the exact names we indicate in this article - you will have browsing and indexing problems.

Other folders are recommended, since they are useful to most stores.

In this article we will cover all these folders.

Required folders

These are the folders that every store needs to have in the CMS to ensure the correct operation of browsing and indexing:

  • Busca (Search)
  • Categoria (Category)
  • Departamento (Department)
  • Login
  • Produto (Product)

See below these basic folders in the 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/en/tutorials/Storefront/Layout/cms-folder-structure_1.png"}}

These folders come by default in the environment of all VTEX stores.

The names of the required folders must not be edited. This can compromise the proper functioning of the store and prevent purchases from being made.

Since folders refer to dynamic pages, their names don't appear on the customer's navigation. In other words, the fact that editing the names is banned does not affect the final text of your URLs, nor the internationalization of your site.

Layout names can be edited without any problem.

Important folders

Some CMS folders are not required but are useful. Hence, we recommend that you do not delete them.

These are:

  • /account: customer's account.
  • /account/orders: customer's orders.

For these two folders, what matters is the control or placeholder that reads their content. Their names can be freely edited.

Since they are private folders, /account and /account/orders must require authentication. See in this article how to ensure they are configured to ask for user authentication.

Useful folders

There are folders that, although not as important as the previous ones, are often useful for most stores. They are the following:

  • /sistema/buscavazia: folder to which the user is directed if the search finds no results.
  • /sistema/{codigoHTTP}: folder that renders error pages according to HTTP status codes, such as 404 (page not found), 401 (unauthorized), and 500 (server error).
  • /sistema/marcas: folder containing layouts for brand pages, which can be customized with exclusive layouts. If there is no specific layout for brands, these pages will be rendered the same way as the search folder. To understand how brand pages work, see the article about VTEX search.
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback