change magento admin nav menu title

change magento admin nav menu title

September 3, 2026 · Illustrated author avatarBy Stefan Bogdanescu
change magento admin nav menu title

Changing Magento Admin Navigation Menu Title Without Modifying Core Files

If you’re new to Magento and want to change the main navigation title from “CMS” to “Content”, it’s crucial to avoid modifying core files directly. This is because editing core files can lead to issues during updates and make your customizations difficult to maintain.

In this tutorial, I’ll guide you through overriding the menu configuration in your module’s config file without touching any core code.

Understanding Magento Menu Configuration

Magento uses an XML-based structure for defining admin navigation menus. The relevant configuration is located within the adminhtml node under <config> in your module’s etc/adminhtml.xml file.

The default CMS menu definition looks like this:

<adminhtml>
    <menu>
        <cms>
            <!-- Menu items go here -->
        </cms>
    </menu>
    <!-- Other adminhtml configurations -->
</adminhtml>

Overriding the Menu Title

To change the “CMS” title to “Content”, you need to override this menu definition in your custom module’s etc/adminhtml.xml file.

First, create a new XML file named menu.xml inside the etc/adminhtml directory of your custom module. Then, add the following content:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Config/etc/config.xsd">
    <adminhtml>
        <menu>
            <cms>
                <!-- This is the part you need to change -->
                <title>Content</title>
            </cms>
        </menu>
    </adminhtml>
</config>

In this file, we define a new title for the cms menu node. Replace “Content” with your desired name.

Applying the Custom Configuration

To apply this custom configuration, you need to ensure that Magento reads it instead of the default core configuration.

  1. Enable the module: Make sure your custom module is enabled by adding its name to the app/etc/modules/Your_Module.xml file:
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Store:etc/config.xsd">
    <module name="Your_Module" setup_version="1.0.0">
        <sequence>
            <module name="Magento_Cms"/>
        </sequence>
    </module>
</config>
  1. Flush the cache: After enabling the module, flush Magento’s configuration cache to apply the changes:
php bin/magento cache:flush

Conclusion

Changing a navigation menu title in Magento without modifying core files is a great way to maintain your customizations and ensure compatibility with future updates.

By following this guide, you’ve learned how to override the menu configuration in your module’s etc/adminhtml.xml file. This approach allows you to keep your code clean and separate from Magento’s core files.

Remember, Magento follows a modular structure that encourages extensions rather than modifications. By leveraging this structure, you can build maintainable solutions for your e-commerce platform.

For more advanced customizations in Magento, consider exploring our other tutorials on Laravel Company. Happy coding!

Extensions Admin Configuration Errors

Our network