Magento Adding Address Attributes To The Checkout

Magento Adding Address Attributes To The Checkout

September 12, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento Adding Address Attributes To The Checkout

Adding Custom Address Attributes to Magento Checkout

Adding custom attributes to your Magento checkout can enhance the customer experience by collecting more relevant information during the purchasing process. In this guide, we’ll walk you through adding a new field for ‘My Car Make’ to the billing address section of the onepage checkout in Magento 2.

Creating a New Customer Address Attribute

Firstly, make sure you have created your custom attribute called ‘mycarmake’ using Magento’s built-in attribute management system. To do this:

  1. Log into your Magento admin panel.
  2. Navigate to Stores > Attributes > Customer.
  3. Click the “Add New Attribute” button.
  4. Set the following properties:
    • Attribute Code: mycarmake
    • Frontend Label: My Car Make
    • Input Type: Text
  5. Save and apply the changes.

Adding the New Field to the Checkout

Next, you need to add this new field to the billing address section of the onepage checkout. Open your theme’s template file located at app/design/default/YOUR_THEME/persistent/checkout/onepage/billing.phtml and find the area marked with <!-- add fields here -->.

Adding the Field to billing.phtml

Add the following code within the ‘add fields here’ section:

<!-- add fields here -->
<li class="fields">
    <div class="field">
        <label for="billing:mycarmake"><?php echo $this->__('My Car Make') ?></label>
        <div class="input-box">
            <input type="text" id="billing[mycarmake]" name="billing[mycarmake]" value="<?php echo $this->htmlEscape($this->getAddress()->getMycarmake()) ?>" title="<?php echo $this->__('My Car Make') ?>" class="input-text" />
        </div>
    </div>
</li>
<!-- end add fields here -->

This code snippet adds a new text field labeled ‘My Car Make’ to the billing address section. The getAddress()->getMycarmake() method retrieves the value of the ‘mycarmake’ attribute for the current customer.

Configuring Attribute Mapping in config.xml

To ensure that the data from this custom field is saved correctly, you need to map it in your module’s etc/config.xml file. Add the following section within the <fieldsets> tag:

<fieldsets>
    <sales_copy_order_billing_address>
        <mycarmake><to_order>*</to_order></mycarmake>
    </sales_copy_order_billing_address>
    <!-- Other fieldset mappings -->
</fieldsets>

This mapping tells Magento to copy the ‘mycarmake’ attribute from the billing address to the order when a sales order is created.

Saving and Testing Your Changes

After making these changes, clear your cache using the command php bin/magento cache:flush in your terminal. Then, log out of the admin panel and place a test order to see if the new ‘My Car Make’ field appears on the checkout page and saves correctly.

Conclusion

Adding custom attributes to Magento’s onepage checkout allows you to gather more specific information from your customers during the purchasing process. By following this guide, you can easily add new fields like ‘My Car Make’ to enhance your store’s functionality without any significant development effort.

Magento 2 Checkout Themes Admin

Our network