How to create a Hello world extension in Magento?

How to create a Hello world extension in Magento?

August 26, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to create a Hello world extension in Magento?

Creating Your First Hello World Extension for Magento

Hello developers! In this tutorial, we’ll guide you through creating your very first Magento extension—a simple “Hello world” extension to help you get started on the right foot. By the end of this post, you’ll have a basic understanding of how to structure an extension and create a simple module.

Prerequisites

Before you dive in, make sure you have the following prerequisites:

  • A local development environment with Magento 2 installed.
  • Familiarity with PHP, XML, and basic git commands.
  • Access to the command line or terminal.

Creating the Extension Folder Structure

First, let’s create the folder structure for your extension. Navigate to the app/code directory of your Magento installation:

cd app/code

Next, create a new namespace for your extension (replace ‘Vendor’ with your actual vendor name):

mkdir Vendor
cd Vendor

Now, create a new module called “HelloWorld”:

mkdir HelloWorld
cd HelloWorld

Your folder structure should look like this:

app/code/Vendor/HelloWorld/

Creating the Module’s XML Configuration

The next step is to create the etc directory and add your module configuration file. Inside etc, create a new XML file called module.xml:

mkdir etc
touch etc/module.xml

Open the module.xml file in your favorite text editor or IDE and add the following content:

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="Vendor_HelloWorld" setup_version="1.0.0">
        <sequence>
            <module name="Magento_Catalog"/>
        </sequence>
    </module>
</config>

Save the file.

Creating the Module’s Composer File

Now, let’s create a composer.json file for your module. In the root directory of your HelloWorld module:

touch composer.json

Open the composer.json file and add the following content:

{
    "name": "vendor/hello-world",
    "description": "A simple hello world extension for Magento 2",
    "type": "magento2-module",
    "version": "1.0.0",
    "license": [
        "GPL-3.0"
    ],
    "authors": {
        "Author Name": "author@example.com"
    },
    "minimum-stability": "stable"
}

Save the file.

Activating and Enabling Your Extension

To activate your extension, open the app/etc/config.php file and add the following line inside the modules array:

'Vendor_HelloWorld'=> 1,

Now, run the following command to enable your module:

bin/magento setup:upgrade

Checking Your Extension

Finally, let’s check if your extension is installed properly. Run the following command:

bin/magento info:module Vendor_HelloWorld

You should see output similar to this:

[Vendor_HelloWorld]: Enabled (1.0.0)

Conclusion

Congratulations! You’ve just created a simple “Hello world” extension for Magento 2. While this example doesn’t demonstrate any functionality, it provides you with the basic structure and steps needed to create your own extensions.

Remember, building an extension is a complex task that requires understanding of Magento’s architecture, PHP development, XML configuration, and database management. If you want to learn more about advanced topics like creating custom blocks, controllers, or models, I recommend checking out Laravel Company’s in-depth Magento 2 tutorials.

Happy coding!

Magento 2 Extensions Configuration CLI

Our network