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

Magento 2 Module Development - Magento 2 Hello World Simple Module

Magento 2 Module development or Magento 2 Hello World trends is increase rapidly while Magento release official version. That why we - Mageplaza - are wring about a topic that introduces how to create a simple Magento 2 Simple Module.

As you know, the module is a directory that contains blocks, controllers, models, helper, etc - that are related to a specific business feature. In Magento 2, modules will be live in app/code directory of a Magento installation, with this format: app/code/<Vendor>/<ModuleName>. Now we will follow this steps to create a simple module which work on Magento 2 and display Hello World.

Basic Topics

Create Hello World module for Magento 2

  • Step 1: Create a directory for the module like above format.
  • Step 2: Declare module by using configuration file module.xml
  • Step 3: Register module by registration.php
  • Step 4: Enable the module
  • Step 5: Create a Routers for the module.
  • Step 6: Create controller and action.

Step 1. Create a directory for the module like above format.

In this module, we will use Mageplaza for Vendor name and HelloWorld for ModuleName. So we need to make this folder: app/code/Mageplaza/HelloWorld

Step 2. Declare module by using configuration file module.xml

Magento 2 looks for configuration information for each module in that module’s etc directory. We need to create folder etc and add module.xml:


And the content for this file:

<?xml version="1.0"?>
<config xmlns:xsi="" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="Mageplaza_HelloWorld" setup_version="1.0.0" />

In this file, we register a module with name Mageplaza_HelloWorld and the version is 1.0.0.

Step 3. Register module by registration.php

All Magento 2 module must be registered in the Magento system through the magento ComponentRegistrar class. This file will be placed in module root directory. In this step, we need to create this file:


And it’s content for our module is:


Step 4. Enable the module

By finish above step, you have created an empty module. Now we will enable it in Magento environment. Before enable the module, we must check to make sure Magento has recognize our module or not by enter the following at the command line:

php bin/magento module:status

If you follow above step, you will see this in the result:

List of disabled modules:

This means the module has recognized by the system but it is still disabled. Run this command to enable it:

php bin/magento module:enable Mageplaza_HelloWorld

The module has enabled successfully if you saw this result:

The following modules has been enabled:
- Mageplaza_HelloWorld

This’s the first time you enable this module so Magento require to check and upgrade module database. We need to run this comment:

php bin/magento setup:upgrade

Now you can check under Stores -> Configuration -> Advanced -> Advanced that the module is present.

Step 5. Create a Routers for the module.

In the Magento system, a request URL has the following format:<router_name>/<controller_name>/<action_name>

The Router is used to assign a URL to a corresponding controller and action. In this module, we need to create a route for frontend area. So we need to add this file:


And content for this file:

<?xml version="1.0"?>
<config xmlns:xsi="" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/etc/routes.xsd">
    <router id="standard">
        <route id="mageplaza" frontName="helloworld">
            <module name="Mageplaza_HelloWorld" />

After define the route, the URL path to our module will be:*

Step 6. Create controller and action.

In this step, we will create controller and action to display Hello World. Now we will choose the url for this action. Let assume that the url will be:

So the file we need to create is:


And we will put this content:

namespace Mageplaza\HelloWorld\Controller\Index;

class Display extends \Magento\Framework\App\Action\Action
  public function __construct(
\Magento\Framework\App\Action\Context $context)
    return parent::__construct($context);

  public function execute()
    echo 'Hello World';

If you have followed all above steps, you will see Hello World when open the url

Create Controller

Enjoyed the tutorial? Spread it to your friends!

Comments for Magento 2 Module Development - Magento 2 Hello World Simple Module

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 Module Development
  • magento 2 simple module
  • magento 2 hello world
  • create module in magento 2
  • magento 2 create extension
  • magento 2 custom module
  • magento 2 extension tutorial
  • magento 2 module creation
  • magento 2 create simple module
  • magento 2 module tutorial
  • magento 2 create module
  • magento 2 create custom module
  • how to create module in magento 2
  • create magento 2 module
  • create module magento 2
  • magento 2 module development
  • magento2 create module
  • Magento 2 hello world
  • magento 2 extension development
  • magento 2 tutorial for beginners step by step
  • magento 2 tutorial for developer