How to disable custom module in magento

How to disable custom module in magento

October 18, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to disable custom module in magento

Magento: How to Disable Custom Modules That Override Core Files

Are you facing issues disabling custom modules in your Magento store, even after using the admin panel’s configuration settings? You’re not alone. Disabling modules that override core files often requires a different approach than usual. Let me walk you through this step-by-step guide.

Understanding the Problem

When you override core Magento files within your custom module extension, the standard method for disabling the module via the admin panel stops working. The system tries to load the core file instead of the overridden version when the module is disabled in the configuration. This leads to unexpected behavior and errors.

Why Disabling Isn’t Working

The issue lies in how Magento manages module dependencies and the loading order of files. When you override a core file, Magento no longer loads it directly; it looks for the overridden version instead. If you disable the module through configuration, Magento doesn’t find the overridden file, so it fails to load the original core file either.

The Correct Approach: Disable the Module Directly

To resolve this issue, we need to disable the module directly in the app/etc folder of your Magento installation. Here’s how:

  1. Connect to your server using an FTP client or SFTP.

  2. Navigate to the app/etc/modules directory.

    /path/to/your/magento/installation/app/etc/modules
    
  3. Locate your custom module XML file (e.g., if your module is called “MyCompany_MyModule”, you’ll find a file named MyCompany_MyModule.xml).

  4. Open the XML file in a text editor.

  5. Change the <active> element from true to false. The content should look like this:

    <config>
        <modules>
            <MyCompany_MyModule>
                <active>false</active>
                <!-- Other configuration remains unchanged -->
            </MyCompany_MyModule>
        </modules>
    </config>
    
  6. Save the changes and upload the file back to the server, overwriting the existing version.

  7. Clear your Magento cache by running this command in a terminal or SSH:

    php bin/magento cache:clean
    php bin/magento cache:flush
    

Verifying the Changes

After completing these steps, your custom module should now be disabled correctly. To verify this:

  1. Refresh your Magento admin panel.

  2. Navigate to System > Configuration > Advanced.

  3. Ensure that your module is listed as “Disabled” in the drop-down menu under “Module Name”.

Best Practices for Overriding Core Files

While it’s possible to override core files, it’s generally recommended to use Magento’s built-in mechanisms like plugin interceptors or preference configuration instead. This approach minimizes conflicts and avoids issues with module disabling.

For more advanced customizations in Magento, consider exploring the following resources:

Conclusion

Disabling custom modules that override core files requires a direct intervention in the module configuration file. By following this guide, you should now be able to disable your custom Magento extensions correctly, even when they’ve overridden core functionality.

Remember, always backup your data before making changes to your Magento installation. If you’re unsure about any part of the process, consider consulting with a professional Magento developer or reaching out to Laravel Company for expert assistance in managing your e-commerce platform.

Happy coding!

Extensions Admin Configuration Orders

Our network