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 Get CustomizeWoo.com FREE * @author Rodolfo Melogli * @compatible WooCommerce 7 * @donate $9 https://businessbloomer.com/bloomer-armada/ */ 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 this snippet?
You can place PHP snippets at the bottom of your child theme functions.php file (delete “?>” if you have it there). CSS, on the other hand, goes in your child theme style.css file. Make sure you know what you are doing when editing such files – if you need more guidance, please take a look at my free video tutorial “Where to Place WooCommerce Customization?”
Does this snippet (still) work?
Please let me know in the comments if everything worked as expected. I would be happy to revise the snippet if you report otherwise (please provide screenshots). I have tested this code with Storefront theme, the WooCommerce version listed above and a WordPress-friendly hosting on PHP 7.3.
If you think this code saved you time & money, feel free to join 14,000+ WooCommerce Weekly subscribers for blog post updates or 250+ Business Bloomer supporters for 365 days of WooCommerce benefits. Thank you in advance 🙂
Need Help with WooCommerce?
Check out these free video tutorials. You can learn how to customize WooCommerce without unnecessary plugins, how to properly configure the WooCommerce plugin settings and even how to master WooCommerce troubleshooting in case of a bug!
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.
