Magento add custom field in One-Page checkout shipping and billing address

Magento add custom field in One-Page checkout shipping and billing address

July 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento add custom field in One-Page checkout shipping and billing address

Adding Custom Fields to Magento One-Page Checkout

Hello developers! Today we’re going to tackle an essential task: adding custom fields to the shipping and billing addresses on Magento’s one-page checkout. We’ll walk through the process step-by-step, ensuring you get it right the first time.

Understanding the One-Page Checkout Structure

Before diving into the code, let’s quickly recap how the one-page checkout works in Magento.

The key files you need to focus on are:

  • app/code/core/Mage/Checkout/controllers/OnepageController.php: Handles the main logic of the checkout process.
  • app/design/frontend/base/default/template/checkout/onepage/billing.phtml and shipping.phtml: These templates render the billing and shipping information.

Adding a Custom Field to Shipping Address

Let’s add a new field, say “Company Name,” to the shipping address. Here are the steps:

Step 1: Add an attribute to Magento

First, you need to create a new attribute in your database using SQL or the Magento admin interface (Catalog > Manage Attributes > Add New Attribute). Create an attribute called “company_name” with the necessary settings.

Step 2: Update the One-Page Checkout Layout

Open app/design/frontend/<your_package>/<your_theme>/layout/checkout.xml and add this code to the <checkout_onepage_billing> block:

<block type="core/template_facade" name="billing.additional fields" template="checkout/onepage/billing/additional.phtml"/>

Step 3: Create a New Template File

Create a new file app/design/frontend/<your_package>/<your_theme>/template/checkout/onepage/billing/additional.phtml:

<div class="field">
    <label for="company_name" class="required"><em>*</em>Company Name:</label>
    <div class="input-box">
        <input type="text" name="billing[company_name]" id="company_name" value="" />
    </div>
</div>

Step 4: Update the One-Page Checkout Form

In app/design/frontend/<your_package>/<your_theme>/template/checkout/onepage/form.phtml, add the attribute “company_name” to the $checkoutForm array in the JavaScript code:

$checkoutForm = new Varien_form('billing');
...
$checkoutForm.addField('company_name', 'text', array(
    'label' => 'Company Name',
    'required' => true,
));

Step 5: Save and Test

Clear your Magento cache, reload the frontend, and you should now see a new field “Company Name” on the shipping address section of the one-page checkout.

Adding Custom Fields to Billing Address

Follow the same steps as above, but:

  • Create an attribute called “billing_company_name”.
  • Update checkout.xml for the <checkout_onepage_billing> block.
  • Create a new template file in app/design/frontend/<your_package>/<your_theme>/template/checkout/onepage/billing/additional.phtml.
  • Add the field to the $checkoutForm array in form.phtml.

Best Practices and Advanced Techniques

If you need more advanced functionality, consider these tips:

  1. Use Magento’s built-in custom attributes: This approach offers better performance and compatibility with core features.

  2. Implement validation: Ensure your new fields are validated correctly to prevent errors during the checkout process.

  3. Test thoroughly: Always test your changes in a staging environment before deploying them to production.

Conclusion

Adding custom fields to Magento’s one-page checkout can greatly enhance the user experience and provide more control over customer data. By following these guidelines, you can easily extend the checkout process with minimal effort.

Remember, proper coding practices like version controlling and regular backups are essential when working on your Magento store. If you’re looking for professional assistance or want to stay updated with the latest trends in e-commerce development, be sure to check out Laravel Company’s expert services.

Happy coding!

Checkout Catalog Database Themes

Our network