Magento translating "Shipping & Handling (Excl.Tax)"

Magento translating "Shipping & Handling (Excl.Tax)"

September 30, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento translating "Shipping & Handling (Excl.Tax)"

Magento Shipping & Handling Translations

Translating “Shipping & Handling (Excl.Tax)” and “Shipping & Handling (Incl.Tax)” in Magento can be a bit tricky compared to other translations. Inline translation might not work as expected, especially for custom tax-related labels.

Understanding the Tax Configuration

Magento stores some default tax-related labels in its core configuration files, which are then used throughout the system. These labels include:

  • Grand Total (Excl.Tax)
  • Grand Total (Incl.Tax)

These specific labels can be found and translated using inline translation because they are defined directly within the Magento codebase.

The Challenge with Shipping & Handling

The “Shipping & Handling” labels, on the other hand, are not directly defined in core configuration files. They are calculated dynamically based on tax rules and rates.

You might have tried to find them in CSV files like Mage_Sales.csv or Mage_Adminhtml.csv, but these files primarily contain general sales and admin translations that don’t include these specific shipping labels.

The Tax.php Approach

One potential solution is indeed the tax.php file. Magento uses this file to define its tax-related behavior, including how it calculates and displays shipping taxes.

Mage::getModel('tax/calculation')->calculate($total)

In this file, you can find methods like collectTaxes that handle the calculation of shipping tax amounts. However, while this allows you to modify the tax calculation itself, it doesn’t directly provide a way to translate the labels “Shipping & Handling”.

A Custom Approach: Observer Events

To solve this, we can utilize Magento’s observer events for the sales order save process.

  1. Create an event-observer

    Create a model that extends Varien_Event_Observer and implement the saveOrderAfter method.

    public function saveOrderAfter($observer)
    {
        $order = $observer->getData('order');
        // Your translation logic here...
    }
    
  2. Register the observer

    In your module’s configuration file (etc/config.xml), add the following:

    <events>
        <sales_order_save_after>
            <observers>
                <your_module_observer>
                    <type>singleton</type>
                    <class>Your_Module_Model_Observer</class>
                    <method>saveOrderAfter</method>
                </your_module_observer>
            </observers>
        </sales_order_save_after>
    </events>
    
  3. The Translation Logic

    In the saveOrderAfter method, you can access the order object and use Magento’s inline translation API to set new labels for the shipping tax amounts.

    $order = $observer->getData('order');
    Mage::app()->getTranslator()->translate(
        'Shipping &amp; Handling (Excl.Tax)',
        array(),
        null,
        'sales'
    );
    

Conclusion

While Magento’s built-in translation tools are powerful, some tax-related labels like “Shipping & Handling” require a more custom approach due to their dynamic nature.

By utilizing observer events and the inline translation API within the sales order save process, you can achieve the desired translations without having to modify core files or rely on non-standard solutions.

Remember to keep your code clean and maintainable by using a dedicated module for these customizations. This approach ensures that your translations remain portable if you decide to upgrade Magento in the future.

For more advanced tax configuration options, consider visiting our blog at laravelcompany.com for detailed guides and best practices.

Admin Configuration Pricing Import/Export

Our network