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!

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;
}