Menu
Feedback
Start here
Tutorials & Solutions
Developers Portal

Known Issues
Support Rules

Frequently Asked Questions
Announcements
Start here
VTEX Modules: Getting Started
StorefrontLegacy CMS Portal
Legacy CMS Portal
5 min read

Layout

The Layout section allows you to create your storefront with HTML and CSS. It is organized into folders and files with specific purposes:

{"base64":"  ","img":{"width":1882,"height":780,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":66567,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tracks/cms/legacy-cms-portal_1.png"}}

  • HTML Templates: build the HTML code and reference JavaScript and CSS files to be used in the website pages.

  • Shelves Templates: manage Shelves templates, i.e., components responsible for rendering a group of products in the storefront.

  • Custom Elements: create the necessary conditions to implement reusable components, such as Footers, in other parts of the store.

  • URL Builder: redirect existing URLs to others of interest. This will avoid indexing errors and help maintain SEO rankings.

  • Files Manager: upload image files for your store website. Store JavaScript, CSS, and image files of the website. If you want to use any of these files in your store, you must reference them within the HTML Templates section.

  • Product Cluster (Collections): create product groups. You can use them to build Campaign or Product Collection landing pages that load specific product clusters.

  • Sites and Channels: configure your store binding and other License Manager settings. To learn more, please refer to the CMS folder structure article.

Settings

The Settings section allows you to configure settings related to your store website, such as its metadata, SEO tags, file types, and more.

{"base64":"  ","img":{"width":1881,"height":826,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":92139,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tracks/cms/legacy-cms-portal_2.png"}}

The Settings section is structured as follows.

  • General: General settings related to the store metadata and shopping options, such as the home page title and the maximum quantity of SKUs in the cart.
  • SEO: Options for customizing SEO keywords and meta tags.
  • Store texts: Database of reusable text variables that are rendered in the storefront.
  • File types: Settings related to asset files, such as image dimensions and size.
  • Geographical areas: Database of the geographical regions where the store products are available.

Legacy CMS folder structure

At VTEX, every new account has folders preinstalled on its CMS. Some of them 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.

The other folders are merely recommended, since they are useful to most stores. Its absence does not affect the accounts.

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/tracks/cms/legacy-cms-portal_3.png"}}

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

The names of the required folders must not be edited.

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).
  • /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 on VTEX search.

VTEX's native controls

Controls are snippets of codes that you can use in your website's templates to perform specific actions.

At VTEX, you will find a number of native controls to render various functionalities.

For example, if you use the <vtex.cmc:productName/> control on a product page, the system will provide the product name to be displayed on the screen.

To add a control, just paste it into the code. The result will be rendered at the position of the code where it is added.

List of Native VTEX Controls

You can check out all available native controls and their respective uses in our List of controls for templates.

References

Guides

Controls

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
CMS - Site Editor
« Previous
Cross-border stores
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
GithubDevelopers PortalCommunityFeedbackSite Map