WooCommerce: Change Address Format For a Specific Country

We’ve already covered a little about address formats when we added a custom House Number field to the WooCommerce Checkout page.

Address formats define the way Billing and Shipping addresses are formatted for the end user. Addresses show on the order received / thank you page, on transactional emails and on some My Account pages, and look like this:

{name}\n{company}\n{address_1}\n{address_2}\n{city}\n{state}\n{postcode}\n{country}

Now, what if you wanted to move the “company” before the customer name, or maybe have “address 1” and “address 2” on the same line, or move “postcode” to the last line? Well, thankfully there is a neat WooCommerce filter called “woocommerce_localisation_address_formats” that allows us to do just that – reformat any address for any country we wish. Enjoy!

In the screenshot, you can see how I’ve changed the US address format to a custom one, so that the company comes first and the two addresses are on the same line separated by a comma.

PHP Snippet: Edit Address Format for Specific Country @ WooCommerce Thank You Page, Emails and My Account

Note: the default address format is the one mentioned in the post intro. Other countries may use a different format, for example Italy has this:

{company}\n{name}\n{address_1}\n{address_2}\n{postcode}\n{city}\n{state_upper}\n{country}

You can see all the custom formats, country codes, and placeholders under the get_address_formats() function in the /woocommerce/includes/class-wc-countries.php plugin file.

Of course, the “\n” thing is a new line. You can also add commas, dots, spaces – but I believe no HTML is allowed. In the example below, for the US country, I’ve moved “company” to the first line, left “name” where it was, put “address 1” and “address 2” on the same line separated by a comma, then “city“, then “state” and “country” on the same line with a blank space in between, and finally the “postcode“. Fun!

/**
 * @snippet       Reformat Billing/Shipping Address By Country
 * @how-to        businessbloomer.com/woocommerce-customization
 * @author        Rodolfo Melogli, Business Bloomer
 * @compatible    WooCommerce 7
 * @community     https://businessbloomer.com/club/
 */

add_filter( 'woocommerce_localisation_address_formats', 'bbloomer_address_company_first' );

function bbloomer_address_company_first( $address ) {
	$address['US'] = "{company}\n{name}\n{address_1}, {address_2}\n{city}\n{state} {country}\n{postcode}";
	return $address;
}

Where to add custom code?

You should place custom PHP in functions.php and custom CSS in style.css of your child theme: where to place WooCommerce customization?

This code still works, unless you report otherwise. To exclude conflicts, temporarily switch to the Storefront theme, disable all plugins except WooCommerce, and test the snippet again: WooCommerce troubleshooting 101

Related content

Rodolfo Melogli

Business Bloomer Founder

Author, WooCommerce expert and WordCamp speaker, Rodolfo has worked as an independent WooCommerce freelancer since 2011. His goal is to help entrepreneurs and developers overcome their WooCommerce nightmares. Rodolfo loves travelling, chasing tennis & soccer balls and, of course, wood fired oven pizza. Follow @rmelogli

2 thoughts on “WooCommerce: Change Address Format For a Specific Country

  1. Hello, Thank you very much…many time that i’m looking for this solution!!! GREAT.

Questions? Feedback? Customization? Leave your comment now!
_____

If you are writing code, please wrap it like so: [php]code_here[/php]. Failure to complying with this, as well as going off topic or not using the English language will result in comment disapproval. You should expect a reply in about 2 weeks - this is a popular blog but I need to get paid work done first. Please consider joining the Business Bloomer Club to get quick WooCommerce support. Thank you!

Your email address will not be published. Required fields are marked *