{"id":409,"date":"2019-05-08T11:03:52","date_gmt":"2019-05-08T11:03:52","guid":{"rendered":"https:\/\/meetanshi.com\/blog\/2019\/05\/08\/create-child-theme-in-magento-2\/"},"modified":"2025-05-22T16:53:12","modified_gmt":"2025-05-22T11:23:12","slug":"create-child-theme-in-magento-2","status":"publish","type":"post","link":"https:\/\/meetanshi.com\/blog\/create-child-theme-in-magento-2\/","title":{"rendered":"How to Create Child Theme in Magento 2"},"content":{"rendered":"\n

Themes in Magento 2 defines the look and feel of your store. Having the graphics and appearance details, the parent theme customization is not advisable.<\/p>\n\n\n\n

Hence, the theme inheritance! <\/i>
(Note<\/strong>: There is no limitation for the level of the theme inheritance)<\/i><\/p>\n\n\n\n

If you want to customize the appearance, it is sane to create child theme in Magento 2 rather than implementing the changes in the parent theme. Because, if the changes are directly implemented in the parent theme, upgrading the Magento version results in loss of theme changes in the parent theme. Banner displayed in the frontend is not designed keeping in mind any custom theme designs. The solution to this issue is to Overriding Extension Files Using Your Magento 2 Theme<\/a>.<\/p>\n\n\n\n

To easily extend the theme and minimize the maintenance tasks, create child theme in Magento 2<\/i> and customize it. By definition, the child theme is a theme that inherits all the properties of the parent theme. It is useful to customize the existing parent theme design as per the requirements.<\/p>\n\n\n\n

Steps to Create Child Theme in Magento 2:<\/h2>\n\n\n\n

Before following these steps, note that “Meetanshi” is the vendor name and “luma” is the parent theme name.<\/p>\n\n\n\n

1. Create a child theme folder named as {parent-theme-name}_child<\/strong> in the following folder path.<\/p>\n\n\n\n

Magento root folder\/app\/design\/frontend\/Meetanshi\/luma_child<\/pre>\n\n\n\n
Name your child theme related to the parent theme. It can be anything that is developer friendly!<\/p>\n\n\n\n
2. Create file theme.xml<\/strong> inside the child theme to specify the parent theme inherited by the child theme<\/p>\n\n\n\n
<theme xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\n       xsi:noNamespaceSchemaLocation=\"urn:magento:framework:Config\/etc\/theme.xsd\">\n    <title>{Child Theme Name}<\/title>\n    <parent>{parent-theme-vendor-name}\/{parent-theme-name}<\/parent>\n    <media>\n        <preview_image>media\/preview.png<\/preview_image>\n    <\/media>\n<\/theme><\/pre>\n\n\n\n
Example:<\/strong><\/p>\n\n\n\n
<theme xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\n       xsi:noNamespaceSchemaLocation=\"urn:magento:framework:Config\/etc\/theme.xsd\">\n    <title>Luma Child<\/title>\n    <parent>Magento\/luma<\/parent>\n    <media>\n        <preview_image>media\/preview.png<\/preview_image>\n    <\/media>\n<\/theme><\/pre>\n\n\n\n
3. Create a registration.php<\/strong> file for registering your child theme.<\/p>\n\n\n\n
<?php\n\\Magento\\Framework\\Component\\ComponentRegistrar::register(\\Magento\\Framework\\Component\\ComponentRegistrar::THEME, \n    'frontend\/{theme-vendor-name}\/{parent-theme-name}_child', \n    __DIR__\n);<\/pre>\n\n\n\n
{theme-vendor-name}<\/strong> should exactly match the vendor folder name. Vendor name should be capitalized. Ex: Meetanshi<\/p>\n\n\n\n
<?php\n \\Magento\\Framework\\Component\\ComponentRegistrar::register(\n    \\Magento\\Framework\\Component\\ComponentRegistrar::THEME,\n    'frontend\/Meetanshi\/luma_child',\n    __DIR__\n );<\/pre>\n\n\n\n
4. Create composer.json<\/strong><\/strong><\/p>\n\n\n\n
{\n    \"name\": \"{theme-vendor-name}\/theme-frontend-{parent-theme-name}-child\",\n    \"description\": \"N\/A\",\n    \"require\": {\n        \"php\": \"~5.5.0|~5.6.0|~7.0.0|~7.1.0|~7.2.0|~7.3.0\",\n        \"{parent-theme-vendor-name}\/{parent-theme-name}\": \"100.0.*\",\n        \"magento\/framework\": \"100.0.*\"\n    },\n    \"type\": \"magento2-theme\",\n    \"version\": \"100.0.1\",\n    \"license\": [\n        \"OSL-3.0\",\n        \"AFL-3.0\"\n    ],\n    \"autoload\": {\n        \"files\": [\n            \"registration.php\"\n        ]\n    }\n}<\/pre>\n\n\n\n
Example:<\/strong><\/p>\n\n\n\n
{\n    \"name\": \"meetanshi\/theme-frontend-luma-child\",\n    \"description\": \"N\/A\",\n    \"require\": {\n        \"php\": \"~5.5.0|~5.6.0|~7.0.0|~7.1.0|~7.2.0|~7.3.0\",\n        \"magento\/luma\": \"100.0.*\",\n        \"magento\/framework\": \"100.0.*\"\n    },\n    \"type\": \"magento2-theme\",\n    \"version\": \"100.0.1\",\n    \"license\": [\n        \"OSL-3.0\",\n        \"AFL-3.0\"\n    ],\n    \"autoload\": {\n        \"files\": [\n            \"registration.php\"\n        ]\n    }\n}<\/pre>\n\n\n\n
5. Create web directory inside the child theme with the following empty directories and files. The whole directory structure for the child theme is:<\/p>\n\n\n\n
\"Magento-2-Create-Child-Theme-File-Path-Meetanshi\"<\/figure>\n\n\n\n
6. Provide access\/permission<\/strong> for child theme directories and files. Go to child theme directory in the terminal and run this command to give permissions for the child theme directory: chmod -R 777 *Note:<\/strong> If you are working in a local or development server you can provide 777 access for both files and directories. If live server, then you have to give 755 for directory and 644 for files.<\/p>\n\n\n\n
7. The admin panel shows the created child theme.<\/p>\n\n\n\n
    \n
  1. Login to admin panel<\/li>\n<\/ol>\n\n\n\n
      \n
    1. Go to Content > Themes<\/strong><\/li>\n<\/ol>\n\n\n\n
      \"1_theme\"<\/figure>\n\n\n\n
        \n
      1. Select child theme in admin configuration<\/li>\n<\/ol>\n\n\n\n
          \n
        1. Go to Content > Design > Configuration<\/strong>.<\/li>\n<\/ol>\n\n\n\n
          \"2_design<\/figure>\n\n\n\n
            \n
          1. Select the child theme<\/li>\n<\/ol>\n\n\n\n
            \"3_select<\/figure>\n\n\n\n
              \n
            1. Save<\/li>\n<\/ol>\n\n\n\n
                \n
              1. Flush the cache<\/li>\n<\/ol>\n\n\n\n
                8. Take a backup of pub\/static folder for images, CSS, and js. Also, delete the static folder and run static content deploy.<\/p>\n\n\n\n
                9. Go to the Magento root folder in your terminal and deploy static content<\/strong> using the following command:<\/p>\n\n\n\n
                php bin\/magento setup:static-content:deploy<\/code><\/pre>\n\n\n\n
                10. The newly created child theme will also deploy in the pub\/static<\/strong> folder.<\/p>\n\n\n\n
                That’s all for creating a Magento 2 child theme! You can now go on with customizing your child theme.<\/p>\n\n\n\n
                Do rate the post with 5 stars if found useful.<\/p>\n\n\n\n
                Thank you.<\/p>\n","protected":false},"excerpt":{"rendered":"
                Themes in Magento 2 defines the look and feel of your store. Having the graphics and appearance details, the parent theme customization is not advisable….<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[34],"tags":[],"class_list":["post-409","post","type-post","status-publish","format-standard","hentry","category-magento"],"acf":[],"_links":{"self":[{"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/posts\/409","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/comments?post=409"}],"version-history":[{"count":4,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/posts\/409\/revisions"}],"predecessor-version":[{"id":15436,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/posts\/409\/revisions\/15436"}],"wp:attachment":[{"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/media?parent=409"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/categories?post=409"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/meetanshi.com\/blog\/wp-json\/wp\/v2\/tags?post=409"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}