Magento admin menu link not showing up

Magento admin menu link not showing up

October 16, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento admin menu link not showing up

Are you facing issues where your custom Magento admin menu links aren’t showing up as expected? You’re not alone. In this tutorial, we’ll dive into the common problem of missing menu links and guide you through a step-by-step solution.

The issue often arises due to incorrect configuration or naming conventions in your module’s config.xml file. Magento uses specific rules for parsing menu definitions, which can sometimes lead to unexpected behavior.

Let’s analyze the provided configurations:

Module A (A>etc>config.xml):

<adminhtml>
    <menu>
        <a module="A">
            <title>Menu Title A</title>
            <sort_order>100</sort_order>
            <children>
                <items module="A">
                    <title>Manage Items A</title>
                    <sort_order>0</sort_order>
                    <action>a/adminhtml_a</action>
                </items>
            </children>
        </a>
    </menu>
</adminhtml>

Module B (B>etc>config.xml):

<adminhtml>
    <menu>
        <b module="B">
            <title>Menu Title B</title>
            <sort_order>100</sort_order>
            <children>
                <items module="B">
                    <title>Manage Items B</title>
                    <sort_order>1</sort_order>
                    <action>b/adminhtml_b</action>
                </items>
            </children>
        </b>
    </menu>
</adminhtml>

The key difference lies in the <a> and <b> tags. Magento interprets these as separate menu containers, but it expects a single root element for the entire menu definition.

The Solution: Reorganizing Your Configuration

To resolve this issue, you need to combine your menu definitions into a single container:

<adminhtml>
    <menu>
        <children>
            <!-- Module A -->
            <a module="A">
                <title>Menu Title A</title>
                <sort_order>100</sort_order>
                <children>
                    <items module="A">
                        <title>Manage Items A</title>
                        <sort_order>0</sort_order>
                        <action>a/adminhtml_a</action>
                    </items>
                </children>
            </a>

            <!-- Module B -->
            <b module="B">
                <title>Menu Title B</title>
                <sort_order>200</sort_order> <!-- Increased sort_order to appear after A -->
                <children>
                    <items2 module="B"> <!-- Renamed items tag for uniqueness -->
                        <title>Manage Items B</title>
                        <sort_order>1</sort_order>
                        <action>b/adminhtml_b</action>
                    </items2>
                </children>
            </b>
        </children>
    </menu>
</adminhtml>

Key Changes Made:

  • Combined menu definitions under a single root <children> element.
  • Renamed the second items tag to items2 to avoid conflicts with the first module’s definition.
  • Increased sort_order for Module B to 200, ensuring it appears after Module A in the admin menu.

Remember, Magento’s menu parsing is somewhat rigid and requires a specific structure. Always ensure your configuration files adhere to these rules:

  1. Use the correct root <adminhtml> element.
  2. Define your menus under a single <children> container.
  3. Use unique tags for each module within the <children> container.
  4. Maintain consistent naming conventions for your menu definitions.

By following this structure, you can guarantee that all your admin menu links will appear as expected in the Magento CMS menu section.

For further reference on customizing the Magento admin interface, check out our comprehensive guide at Laravel Company.

Extensions Admin Configuration Orders

Our network