What’s in this topic
When you create a Magento theme, you might need to create override files for default theme and module view files. To do so, you must determine which template, layout, and style files Magento uses. This topic describes how to do this.
To locate the template that is responsible for a specific part of the storefront or Admin, you can use Magento built-in template hints.
To enable template hints:
Click Stores > Settings > Configuration > ADVANCED > Developer.
In the Scope: dropdown in the upper-left corner select the view for which you want the template hints.
- In the Debug tab, set Template Path Hints for storefront to Yes. To enable path hints for Admin set Template Path Hints for Admin to Yes.
- To save the changes, click Save Config in the upper-right corner.
You can also use the CLI to enable/disable template hints.
bin/magento dev:template-hints:enable command to enable template hints and the
bin/magento dev:template-hints:disable command to disable them. Do not forget to clear the cache after running the commands. For example:
1 bin/magento dev:template-hints:enable
1 Template hints enabled.
1 bin/magento cache:clean config full_page
Now that you have enabled template hints, reload the page that you want to modify. If you enabled hints for storefront with URL Param, reload the page with the param
?templatehints=magento in the URL and review the path for the template file or files that the template hints show.
Here is an example of a storefront category page with template hints enabled:
In this example, the mini shopping cart page element is defined by the
(the template name is above the element)
Here is how the Customers page looks with template hints enabled in the Admin:
Alternatively, you can perform a text search in the file system by using system generated titles, CSS class names, block titles, labels, or links text as search terms.
For example, using a browser debug tool, you can define that the minicart block css class is
A search through the app directory for occurrences of “minicart-wrapper” in
.phtml files returns the
Since it is not recommended to edit the default files, you need to add overriding files if you want to customize the template. For details about overriding templates please refer to Customizing Theme Template.
Just like templates, layouts are saved on a per-module basis. You can easily locate the layout file by determining in which module the templates for the element you are interested in reside in.
After you have determined the module, you can search for the layout in the following locations:
There is no straightforward algorithm how to define at once the exact layout file, but in most cases layout file names are self descriptive. Also you can search them for mentions of the corresponding templates.
Let’s say you need to locate the layout that is responsible for displaying mini shopping cart on the storefront, when the Blank theme by Magento is applied for the store view.
Using the Template Hints we determine that the template is
app/code/Magento/Checkout/view/frontend/templates/cart/minicart.phtml, and in the path, we see that it belongs to the
Let’s search for the layout following the fallback scheme:
- Check the
app/design/frontend/Magento/blank/Magento_Checkout/layout. To locate the required layout, search this directory for occurrences of the template name, “ minicart.phtml “. No matching file is found, so we proceed to the next fallback level, which is the parent theme layouts.
- We can find the info about parent theme in a theme configuration file
theme.xml, the parent theme name is specified there in the
<parent></parent>node. In the
<parent>node, which means the Blank theme has no parents. So we should search on the next fallback level which is the module layouts.
- The Magento_Checkout layouts are located in
app/code/Magento/Checkout/view/frontend/layout/. After searching this directory for occurrences of “
minicart.phtml”, we define that the layout we are looking for is
After you located the necessary layout file, you can create your custom layout file with the corresponding name in your theme folder to add extending or overriding content. Please see Customizing Theme Layouts for more details.
To locate a CSS rule that is applied to a certain element, find the template for the page that contains the element. Or you can use browser debugging tools, to locate the class name.
After you find the class name, use text search in the theme and module styles directories to locate the
.css file that defines the class. Perform the search according to the following fallback scheme:
- Theme styles
- Module theme styles
- Parent theme styles
- Parent theme Module styles
- Module styles for the
- Module styles for the
Let’s find the file defining on the CSS classes used for displaying the mini shopping cart on the storefront, when the Blank theme by Magento is applied for the store view.
In the mini shopping cart template
app/code/Magento/Checkout/view/frontend/templates/cart/minicart.phtml the top level element has
So, let’s search for occurrences of “
minicart-wrapper” in according to the fallback scheme:
- Search in
app/design/frontend/Magento/blank/web/css, the search returns no results.
- Search in
minicart-wrapper” style is defined in
After you determine which
.less file defines the class, you can override the default class definition in your custom
.less files. For details, see CSS in themes.