Cant add custom button to adminhtml in Magento

Cant add custom button to adminhtml in Magento

October 18, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Cant add custom button to adminhtml in Magento

Resolving “Cant Add Custom Button to Adminhtml in Magento”

As a senior developer experienced in Magento customizations, I understand the frustration when your custom button isn’t showing up in the adminhtml. Let’s troubleshoot this step-by-step.

Understanding Your Current Setup

You’ve created a new module named Parcel with the required files:

  • Block: app/code/local/Module/Parcel/Block/Adminhtml/Sales/Order/View.php
  • Config XML: app/code/local/Module/Parcel/etc/config.xml
  • Module XML: app/Module_Paragraph.xml

Your block file correctly extends the base Mage_Adminhtml_Block_Sales_Order_View and adds a custom button using the _addButton() method.

public function __construct() {
    parent::__construct();
    $this->addButton('button_id', array(
        'label'     => Mage::helper('xxx')->__('Some action'),
        'onclick'   => 'jsfunction(this.id)',
        'class'     => 'go'
    ), 0, 100, 'header', 'header');
}

The config.xml file properly configures the rewrite of the sales order view block.

Identifying the Issue

Your configuration looks correct on a surface level. The issue might lie in the module declaration or Magento’s caching mechanisms.

Potential Solutions

1. Check Module Enabling

Ensure that your module is enabled correctly:

  • Log into the admin panel.
  • Navigate to System > Configuration > Advanced.
  • Click on Disable Modules Output under the Advanced tab.
  • Find your Module_Parcel module and make sure it’s set to 1 (Enabled).

2. Clear Cache

Magento has a caching system that might prevent changes from appearing immediately.

  • In your admin panel, go to System > Tools > Cache Management.
  • Select all cache types and click “Flush Magento Cache”.

3. Verify the Helper

In your button definition:

'label'     => Mage::helper('xxx')->__('Some action'),

Ensure that you have a helper class named Helper in your module’s namespace (Module_Parcel_Helper). If not, create one and provide the required translations.

4. Debug with Logs

Add some debug code to your block file:

public function __construct() {
    Mage::log("Constructed View Block");
    parent::__construct();
}

Check Magento’s system.log or exception.log for any error messages indicating why the button isn’t being added.

Conclusion and Next Steps

Magento customizations often require a combination of correct code, proper configuration, and clearing cache. If you’ve followed this guide and the issue persists, consider reaching out to Magento support or consulting with an experienced Magento developer from Laravel Company.

Remember, patience is key when dealing with complex e-commerce platforms like Magento. Proper testing on a staging environment before applying changes to your live site can save you from potential downtime.

Don’t hesitate to explore the official Magento Developer Documentation and community forums for more advanced customization techniques. Happy coding!

Extensions Admin Configuration Orders

Our network