Magento - How to override persistent billing.phtml using custom module

Magento - How to override persistent billing.phtml using custom module

August 31, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento - How to override persistent billing.phtml using custom module

Magento: Overriding Persistent Billing.phtml Using Custom Module

Hello Magento developers! Today we’re going to troubleshoot one of the most common issues faced when trying to override core template files using custom modules.

The Problem

Our user is struggling to override the billing.phtml file located at app/design/frontend/base/default/template/persistent/checkout/onepage/billing.phtml. They have a custom module activated with the configuration file residing in the correct location (app/code/local/CustomCheckout/Checkout/etc/config.xml).

The Current Setup

The user has correctly set up their module to extend the core checkout functionality. Here’s how their config.xml looks:

<config>
    <modules>
        <CustomCheckout_Checkout>
            <version>1.0.0</version>
        </CustomCheckout_Checkout>
    </modules>
    <frontend>
        <routers>
            <checkout>
                <args>
                    <modules>
                         <CustomCheckout_Checkout before="Mage_Checkout">CustomCheckout_Checkout</CustomCheckout_Checkout>
                    </modules>
                </args>
            </checkout>
        </routers>
        <layout>
            <updates>
                <checkout>
                    <file>persistent.xml</file>
                </checkout>
            </updates>
        </layout>
    </frontend>
</config>

They are trying to override the persistent.xml layout, which calls the billing.phtml file. This new layout XML is placed at app/design/frontend/default/CustomCheckout/layout/persistent.xml:

<layout version="0.1.0">
    <checkout_onepage_index>
        <reference name="checkout.onepage.billing">
            <action method="setTemplate">
                <template>checkout/onepage/billing.phtml</template>
            </action>
        </reference>
    </checkout_onepage_index>
</layout>

The modified billing.phtml file is placed in the expected location: app/design/frontend/default/CustomCheckout/template/checkout/onepage/billing.phtml.

The Error

However, all their efforts are being thwarted as the new billing.phtml isn’t being picked up by the system. They’ve tried everything but still can’t get it working.

The Solution

The issue lies in the path specified for the template file in the layout XML. When you override a core template file, Magento looks for the new version under your theme’s template directory structure.

In this case, since they’re using app/design/frontend/default/CustomCheckout as their theme folder, the correct path should be:

<action method="setTemplate">
    <template>checkout/onepage/billing.phtml</template>
</action>

The setTemplate action expects a relative path from your theme’s template directory. So if you’re using a custom theme named “CustomCheckout”, the correct relative path is simply checkout/onepage/billing.phtml.

Conclusion

Remember, when overriding core templates in Magento, always ensure:

  1. Your custom module is properly configured to extend the appropriate functionality.
  2. The layout XML file for your module is placed correctly under your theme’s layout directory.
  3. The relative path specified in the layout XML matches the structure of your theme’s template folder.
  4. The modified template files are saved with the correct file permissions.

If you’re still facing issues, don’t hesitate to reach out for further assistance! For more in-depth guides on Magento customization and development, head over to Laravel Company - your go-to resource for all things e-commerce.

Checkout Extensions Themes Configuration

Our network