How to create a Helloworld module in Magento2?

How to create a Helloworld module in Magento 2?

So In this blog We will discuss the topic of how to create a Hello World module in Magento 2. In order to help you have the clearest and easiest way to create the hello world module. At the end of blog the module’s output will say “Hello world!” in the block content on a custom frontend route.

Follow the below steps to create HELLO WORLD module.

All of our custom modules in Magento 2 go under the app/code directory. And the modules have a 2 part naming structure, i.e, MerchantName/VendorModuleName. This is so that the modules can be organised more efficiently. So, assuming our MerchantName is V4U and our first VendorModuleName will be called Helloworld, the directory structure for our module is app/code/V4U/Helloworld/.

A Magento 2 module is found in app/code/MerchantName/ModuleName/. So basically Magento 2 for any module/extension there are mainly three required/mandatory files :

  • registration.php : Both Composer and Magento use this file. Composer to determine which files to autoload (loading automatically based on their namespace path).
  • composer.json : Depending on how the module will be installed, this may or may not be necessary. I always include it in my modules as this will likely be required in the future. Because It tells Composer about requirements and paths.
  • etc/module.xml : This file will likely become deprecated in favour of composer.json. So In this file, we specify the module’s name (which must match the name specified in registration.php). You also specify any modules on which this module depends with the sequence element.

Note : So our module will mostly work without a composer.json file at this time. However, It will run into an error when try to use the Magento CLI to uninstall a module.

And GitHub Repository of the Module:

Here is the step-by-step guide on creating Magento 2 module/extension.

So I have set the module’s MerchantName(Namespace) as V4U and VendorModuleName (module’s name) as Helloworld. So, our module is V4U_Helloworld.

(01) Register your Module : You have to register your module in your Magento 2. This is done through Magento ComponentRegistrar class. You should create a new file named registration.php in your module’s directory.


(02) Create composer.json file :


(03) Create Module’s Configuration File :


(04) Create Module’s Frontend Router File :


(05) Create Controller Class : In Magento 2, we should create a separate controller class for each action because each controller class will only have one method named execute().


(06) Create Block Class :


(07) Create Design Layout File :


(08) Create Design Template File :


(09) Run the below commands to enable and register the module :

php bin/magento module:enable V4U_Helloworld

php bin/magento setup:upgrade

If It doesn’t work, then you can try using sudo at the beginning of the command.

sudo php bin/magento setup:upgrade

php bin/magento cache:clean

php bin/magento cache:flush

To check the enabled/disabled status of all cache types, you can run the following command:

php bin/magento cache:status

Now check result. So in our example, the final URL will look like this:


🙂 Happy Coding. Keep Liking & Sharing 💻


So Home
Tagged , , , ,