how to create sub menu in magento admin using module

how to create sub menu in magento admin using module

July 23, 2026 · Illustrated author avatarBy Stefan Bogdanescu
how to create sub menu in magento admin using module

Creating Sub-Menus in Magento Admin: A Comprehensive Guide

As a senior developer working on Magento modules, you’ll often need to customize the admin interface to fit your specific needs. One common task is adding a sub-menu for easy navigation within your module’s admin area.

In this post, we’ll guide you through creating a new sub-menu in the Magento admin section using version 1.5.1.0. By following these steps, you can seamlessly integrate your custom menu into the existing framework.

Step 1: Define Your Module

First, ensure that your module is correctly defined in the app/etc/modules/Your_Module.xml file:

<?xml version="1.0"?>
<config>
    <modules>
        <Your_Company_Your_Module>
            <active>true</active>
            <codePool>local</codePool>
            <depends>
                <Mage_Core />
                <Mage_Catalog />
            </depends>
        </Your_Company_Your_Module>
    </modules>
</config>

Step 2: Create the Menu Configuration

Next, you need to create a configuration file for your new sub-menu. In the app/code/local/Your/Company/Your/Module/etc/config.xml file, add the following code within the <global> tags:

<adminhtml>
    <menu>
        <your_module translate="title" module="your_module">
            <title>Your Module</title>
            <sort_title>70</sort_title>
            <children>
                <your_sub_menu translate="title" module="your_module">
                    <title>Your Sub-Menu</title>
                    <sort_order>10</sort_order>
                    <action>adminhtml/your_module/your_controller/your_action</action>
                </your_sub_menu>
            </children>
        </your_module>
    </menu>
</adminhtml>

This configuration tells Magento to create a new menu titled “Your Module” under the “Catalog” main menu. Within this sub-menu, it adds another item called “Your Sub-Menu,” which links to your custom controller action.

Step 3: Create the Controller and Action

Now that you have defined your sub-menu, you need to create the corresponding controller and action in app/code/local/Your/Company/Your/Module/controllers/YourController.php:

<?php

class Your_Company_Your_Module_YourController extends Mage_Adminhtml_Controller_action
{
    public function yourAction()
    {
        $this->_initLayout();
        $this->getLayout()->getBlock('head')->setTitle($this->__('Your Sub-Menu'));
        $this->renderLayout();
    }
}

This controller action simply initializes the layout and sets a title for the page, but you can extend it to include any necessary logic or views.

Conclusion

By following these steps, you should now have successfully created a new sub-menu within your Magento admin section. This sub-menu will appear under the “Catalog” main menu, as specified in the configuration file.

Remember that proper module definition and correct XML configuration are crucial for the sub-menu to appear correctly in the admin interface. Always ensure your code is well-organized and follows best practices for maintainability and performance.

If you’re looking for more advanced customizations or need professional support with your Magento development, don’t hesitate to reach out to Laravel Company – we specialize in helping businesses unlock the full potential of Magento platforms.

Catalog Extensions Themes Admin

Our network