Stores are made up of several different pages, each one having a different layout and content. When creating a store from scratch in VTEX IO, some default pages with predefined URLs are already available to you, such as:

• store.home - Home page
• store.product- Product page
• store.search - Search Results page
• store.account - Client Account page
• store.login - Login page
• store.orderplaced - Order Placed page

You can manage each page's title and template in the Pages section, within the admin's CMS.

However, you may want to create a new custom page to meet your store's specific needs. In this case, you must create a new URL and template to accompany it.

Follow the steps below and learn how to define a different layout and path for a new store page:

1. Create a new template in your Store Theme.
2. Create your new page's path.
3. Add content to your page.
4. Make your new theme content publicly available.

A template sets the page layout, so if you want to create a custom page for your store you also will need to create a new template for it.

In order to do so, you first must choose one of three template types to host your new page:

• Product - For pages that must deal with the content of a single product, such as a product details page. Adding any new product automatically generates a new product page.
• Product collections - For pages containing a group of products, such as the Search Result page.
• Standard - For pages with no specific product content. For instance, the Home page.

Even though Standard pages are not directly linked to any specific product, they may display shelves or lists of any chosen group of products. The main difference is that the group of products shown on such a page does not depend on the URL query but only on the setting of the shelf itself.

Let's suppose we are going to create a simple About Us page for a store. At first, the page is not directly connected to any specific product, we should create a custom Standard template for it with an image in its left column and a title and text content in its right column:

1. In your Store Theme's code, declare a new template within your blocks folder or blocks.jsonc file.

2. Fill it out with the blocks that will set the desired layout. For example:

For more information, refer to the Flex Layout documentation.

Now that your page layout has been defined in the Store Theme code, the next step is to define the page's path to make the page accessible. You can define it through direct code changes or by using the account's admin.

Through code changes

1. In your theme's source code, access the routes.json file. It can be found in the store folder.
2. There, add a path to the recently created template's JSON:

3. Save your files.
4. Link the theme to a Development workspace. You will be able to access and see your new page live through your workspace, using the following format: {workspaceName}--{accountName}.myvtex.com/{pathName}.

Using the account admin

If you prefer to set the new page path using account admin, you must first must release your changes regarding template creation and install the new version of your Store Theme in a production workspace.

Once your changes are set up in a Production workspace, you will be able to use the admin's CMS to create the page's path:

1. Access the admin's Pages section.
2. Click on Create New.
3. Choose the desired URL and any created template. For instance, the About Us page template previously created:

Notice that a template only sets the page layout. Hence, any new template can be set on any page that accepts templates of the same type as the page itself.

When editing any content using the CMS section, it's always good to make your changes in a production workspace. Therefore, make sure you are not creating your new custom page in the store's master workspace.

Your new page now has a custom layout, thanks to the newly created template, and can be accessed thanks to its route creation. The next step is editing its content.

You can define your page content by performing changes directly to your Store Theme app or using the admin's Site Editor. When using this last one, you can browse to your custom page or simply write its URL in the Page URL field. For example:

If you are happy with the changes to your Store Theme, make your new theme content public. Up until this point, the changes were performed in your development workspace. Access our documentation on making your theme content publicly available and follow the steps detailed there.