Adobe Commerce 2.3 reached end of support in September 2022.

Templates customization walkthrough

What’s in this topic

This topic walks you through how to customize a template.


Set your Magento application to the developer mode. The application mode influences the way static files are cached by Magento. The recommendations about theme development we provide in this chapter are developer/default-mode specific.

Template customization walkthrough

To customize a template:

  1. Locate the template which is associated with the page/block you want to change using template hints.

  2. Copy the template to your theme folder according to the template storing convention.

  3. Make the required changes.

To add a new template in a theme:

  1. Add a template in your theme directory according to the template storing convention.

  2. Assign your template to a block in the corresponding layout file.

If you add a new .html template, and then edit it, the changes will not apply until you delete all files in the pub/static/frontend and var/view_preprocessed directories and reload the pages. You can delete the files manually or run the grunt clean:<theme_name> command in CLI. For details about using Grunt in Magento see Installing and configuring Grunt.

Walkthrough illustration: adding a message to the customer review form

A small customization to illustrate the walkthrough: in their Orange theme, the ExampleCorp company wants to add a short text to the product review form to encourage customers to write reviews.

The following image illustrates how the default review form looks like:

Default review form

To add the text, ExampleCorp needs to override the default review form template in the Orange theme.

First, they copy the form.phtml template from <Magento_Review_module_dir>/view/frontend/templates to the corresponding subdirectory in the Orange theme directory: app/design/frontend/ExampleCorp/orange/Magento_Review/templates.

In the theme form.phtml file they add the HTML snippet with the message before the <form>:

HTML snippet to add

Here’s how the form will look when the Orange theme is applied in a store:

Review form with the new message added