Black Friday & Cyber Monday - Up to 100% Off Explore

Magento 2 Create View: Block, Layouts, Templates

In this topic Magento 2 Create: Block, Layouts, Templates we will learn about View in Magento 2 including Block, Layouts and Templates. In previous topic, we discussed about CRUD Models . As you know, a View will be use to output representation of the page. In Magento 2, View is built by three path: block, layout and template. We will find how it work by building the simple module Hello World using View path.

To create view in Magento 2

  • Step 1: Call view in controller
  • Step 2: Create layout file .xml
  • Step 3: Create block
  • Step 4. Create template file .phtml

Step 1: Call view in controller

In the previous Hello World Module topic, we have build a simple module and show the Hello World message on the screen directly by controller. Now we will edit it to call view to render page.

File: app/code/Mageplaza/HelloWorld/Controller/Index/Display.php

namespace Mageplaza\HelloWorld\Controller\Index;

class Display extends \Magento\Framework\App\Action\Action
	protected $_pageFactory;
	public function __construct(
		\Magento\Framework\App\Action\Context $context,
		\Magento\Framework\View\Result\PageFactory $pageFactory)
		$this->_pageFactory = $pageFactory;
		return parent::__construct($context);

	public function execute()
		return $this->_pageFactory->create();

We have to declare the PageFactory and create it in execute method to render view.

Step 2: Create layout file .xml

The Layout is the major path of view layer in Magento 2 module. The layout file is a XML file which will define the page structure and will be locate in {module_root}/view/{area}/layout/ folder. The Area path can be frontend or adminhtml which define where the layout will be applied.

There is a special layout file name default.xml which will be applied for all the page in it’s area. Otherwhile, the layout file will have name as format: {router_id}_{controller_name}_{action_name}.xml.

You can understand the layout in detail in this Magento topic , and the instruction of a layout structure.

When rendering page, Magento will check the layout file to find the handle for the page and then load Block and Template. We will create a layout handle file for this module:

File: app/code/Mageplaza/HelloWorld/view/frontend/layout/helloworld_index_display.xml

<?xml version="1.0"?>
<page xmlns:xsi="" layout="1column" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <referenceContainer name="content">
        <block class="Mageplaza\HelloWorld\Block\Display" name="helloworld_display" template="Mageplaza_HelloWorld::sayhello.phtml" />

In this file, we define the block and template for this page:

Block class: Mageplaza\HelloWorld\Block\Display Template file: Mageplaza_HelloWorld::sayhello.phtml

Step 3: Create block

The Block file should contain all the view logic required, it should not contain any kind of html or css. Block file are supposed to have all application view logic.

Create a file:


The Block for this module:

namespace Mageplaza\HelloWorld\Block;
class Display extends \Magento\Framework\View\Element\Template
	public function __construct(\Magento\Framework\View\Element\Template\Context $context)

	public function sayHello()
		return __('Hello World');

Every block in Magento 2 must extend from Magento\Framework\View\Element\Template. In this block we will define a method sayHello() to show the word “Hello World”. We will use it in template file.

Step 4. Create template file

Create a template file call sayhello.phtml


Insert the following code:

echo $block->sayHello();

In the layout file, we define the template by Mageplaza_HelloWorld::sayhello.phtml. It mean that Magento will find the file name sayhello.phtml in templates folder of module Mageplaza_HelloWorld. The template folder of the module is app/code/{vendor_name}/{module_name}/view/frontend/templates/.

In the template file, we can use the variable $block for the block object. As you see, we call the method sayHello() in Block. It’s done, please access to this page again ( and see the result.

If you got this error message: Exception printing is disabled by default for security reasons, this topic may help.

Enjoyed the tutorial? Spread it to your friends!


Comments for Magento 2 Create View: Block, Layouts, Templates

Please leave comments if you have any questions, feedbacks.

Module Development

You also may like these Magento 2 Extensions

One Step Checkout

10 reviews

Layered Navigation

12 reviews


no review

Shop By Brand

3 reviews

People also searched for:

  • magento 2 block
  • magento 2 block class
  • magento 2 block template
  • magento 2 create a new template
  • magento 2 create a template
  • magento 2 create block
  • magento 2 create block and template
  • magento 2 create block from template
  • magento 2 create block with template
  • magento 2 create layout
  • magento 2 create template
  • magento 2 create template block
  • magento 2 create template file
  • magento 2 create template page
  • magento 2 create template tutorial
  • magento 2 custom template block
  • magento 2 custom template cms
  • magento 2 custom template for category
  • magento 2 custom template for homepage
  • magento 2 custom template for product
  • magento 2 custom template layout
  • magento 2 custom template not working
  • magento 2 custom template tutorial
  • magento 2 custom template variables
  • magento 2 custom template xml
  • magento 2 custom widget template
  • magento 2 customer account create template
  • magento 2 layout xml
  • magento 2 create block programmatically
  • magento 2 createblock