How to include multiple html file in another phtml file?

How to include multiple html file in another phtml file?

September 18, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to include multiple html file in another phtml file?

Including Multiple PHTML Files in Magento 2

Introduction

As you transition from Laravel to Magento 2, you’ll notice some key differences in how files are structured and included within the view layer. In this post, we’ll guide you through including multiple phtml files within a single one using Magento 2’s template structure.

Understanding the Magento 2 Template Hierarchy

Before diving into the code, let’s quickly recap Magento 2’s template hierarchy:

  • The root directory for your theme is located at app/design/frontend/<Vendor>/<theme>
  • Within this directory, you’ll find the templates folder where all your phtml files should reside
  • Magento follows a modular approach, with each module containing its own templates

Including PHTML Files

To include one phtml file within another in Magento 2, you can use the include directive. Here’s how to do it:

  1. First, ensure that all your phtml files are located within the correct directories following the template hierarchy.

For example:

app/design/frontend/<Vendor>/<theme>
└── templates
    └── Wo_EyeTest
        ├── eyetestSteps
        │   ├── step1.phtml
        │   └── step2.phtml
  1. Now, let’s say you have a parent.phtml file in your theme’s root folder and you want to include the step1.phtml and step2.phtml files from the eyetestSteps directory.
<!-- app/design/frontend/<Vendor>/<theme>/templates/parent.phtml -->
<div id="main-container">
    <?php echo $this->include('Wo_EyeTest/eyetestSteps/step1') ?>

    <h2>Step 2</h2>
    <?php echo $this->include('Wo_EyeTest/eyetestSteps/step2') ?>
</div>

In this example:

  • The $this->include() function is used to render the contents of the specified phtml file
  • The first parameter is the module name followed by the path to the template file (without the .phtml extension)

Handling Subfolders

If your files are nested within subdirectories, like in your case with step1 and step2, you must include them relative to their parent directory:

<!-- app/design/frontend/<Vendor>/<theme>/templates/parent.phtml -->
<div id="main-container">
    <?php echo $this->include('Wo_EyeTest/eyetestSteps/step1') ?>

    <h2>Step 2</h2>
    <?php echo $this->include('Wo_EyeTest/eyetestSteps/step2') ?>
</div>

Conclusion

Including phtml files in Magento 2 is straightforward once you understand the template hierarchy. By using the include() function, you can easily reuse and organize your view logic across multiple files.

Remember to always place your templates within their respective directories following the Magento 2 conventions. This ensures a clean and maintainable codebase that aligns with best practices.

For more advanced techniques in Magento development, be sure to explore Laravel Company’s resources for insights into project setup, customization, and optimization in the Magento ecosystem.

Magento 2 Extensions Themes

Our network