WooCommerce: Rename “State” Label @ Checkout

Here’s a super quick snippet you can use to rename the WooCommerce checkout “state” field label for both billing & shipping.

Of course you can learn by example and apply the same snippet to other checkout fields, all yopu need to change is the field ID. Enjoy!

How to rename the “State” checkout field

PHP Snippet: Rename State Label @ Checkout Page

 * @snippet       Rename State Field Label @ WooCommerce Checkout
 * @how-to        Get CustomizeWoo.com FREE
 * @author        Rodolfo Melogli
 * @compatible    WooCommerce 3.6.4
 * @community     https://businessbloomer.com/club/

add_filter( 'woocommerce_default_address_fields' , 'bbloomer_rename_state_province', 9999 );

function bbloomer_rename_state_province( $fields ) {
    $fields['state']['label'] = 'Province';
    return $fields;

If you want to rename other fields, just replace ‘state‘ inside the square brackets with:

  • country
  • first_name
  • ‘last_name
  • ‘company
  • address_1
  • address_2
  • city
  • postcode

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

  • WooCommerce: Cart and Checkout on the Same Page
    This is your ultimate guide – complete with shortcodes, snippets and workarounds – to completely skip the Cart page and have both cart table and checkout form on the same (Checkout) page. But first… why’d you want to do this? Well, if you sell high ticket products (i.e. on average, you sell no more than […]
  • WooCommerce: Disable Payment Method If Product Category @ Cart
    Today we take a look at the WooCommerce Checkout and specifically at how to disable a payment gateway (e.g. PayPal) if a specific product category is in the Cart. There are two tasks to code in this case: (1) based on all the products in the Cart, calculate the list of product categories in the […]
  • WooCommerce: Add Privacy Policy Checkbox @ Checkout
    Here’s a snippet regarding the checkout page. If you’ve been affected by GDPR, you will know you now need users to give you Privacy Policy consent. Or, you might need customer to acknowledge special shipping requirements for example. So, how do we display an additional tick box on the Checkout page (together with the existing […]
  • WooCommerce: Redirect to Custom Thank you Page
    How can you redirect customers to a beautifully looking, custom, thank you page? Thankfully you can add some PHP code to your functions.php or install a simple plugin and define a redirect to a custom WordPress page (as opposed to the default order-received endpoint). This is a great way for you to add specific up-sells, […]
  • WooCommerce: Disable Payment Gateway by Country
    You might want to disable PayPal for non-local customers or enable a specific gateway for only one country… Either way, this is a very common requirement for all of those who trade internationally. Here’s a simple snippet you can further customize to achieve your objective. Simply pick the payment gateway “slug” you want to disable/enable […]

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

26 thoughts on “WooCommerce: Rename “State” Label @ Checkout

  1. thanks, but on load, it works. then after a second it changes to its old state

    1. Weird, works perfectly on my Storefront theme. Can you disable your server-side and WordPress-side cache + temporarily disable all plugins but Woo and also temporarily switch your theme. Does the snippet work?

      1. Also for me on load, it works. then after a second it changes to its old state

        I think the problem is coming from address-i18n.min.js file

        1. Ok thank you. What’s your store address country (under WooCommerce > Settings)?

  2. Howdy, it changed the naming for me on the “Shipping” address fields but not the “Billing” address fields.

    1. That’s weird, works for both on my dev site. Please try to see if you have other plugins / code targeting the billing fields already, and temporarily disable them all to see if my snippet actually works

  3. Excellent. Works on The Retailer.
    Just one question. In other comment you mention handling foreign characters, but I`m stumped on how to “wrap it in a __() function:”.

    For example if I wanted to replace the field ‘state’ as in the example, with the Japanese character for country ε›½, the obvious solution of replace ‘province’ with ‘ε›½’ doesn`t work.

    Could you give an example of what wrapping the would look like in this case?

    add_filter( 'woocommerce_default_address_fields' , 'bbloomer_rename_state_province', 9999 );
    function bbloomer_rename_state_province( $fields ) {
        $fields['state']['label'] = 'ε›½';
        return $fields;

    Thank you.

    1. Maybe?

      $fields['state']['label'] = __( 'state', 'woocommerce' );
      1. Just how good are you ? !
        Works perfectly. THANKγ€€YOU.

  4. I don’t know why and how can influence but this code is adding 2 more seconds on add to cart.
    Do you have any ideas about why is happening?

    1. Not sure, haven’t noticed that honestly

  5. Worked Perfectly with Astra!

  6. Can I add another field: customer id number to the form.
    I need a new one and does not want to rename an existing one.

  7. Hello Rodolfo,
    i want this snippet work with multi language woocommerce , sorry i know this might be a newbie question

    1. No worries. In order to make a string translatable you have to wrap it in a __() function: https://codex.wordpress.org/I18n_for_WordPress_Developers#Translatable_strings – hope this helps πŸ™‚

  8. no longer works

    1. Tried with a different theme and no other plugins than Woo already?

      1. For me it works perfectly. I used the code snipets plugin and I am using the OceanWP theme.

        1. Nice!

  9. Hello Rodolfo!
    Exactly where I was stuck after our discussion on the CustomizeWoo 2.0 course comment area… BTW, I highly recommend this course to all people who want to improve their Woocommerce skills.
    Related with this snippet: it does work only for Italy, where you are from :)). If I choose Italy, the label changes in “Province”. But for other countries (eg United Kingdom or Romania), the “County” label will be there. For the United States, the label is “State”, and so on.
    Please advise how to proceed for these situations. Thank you!

    1. I FOUND MYSELF. There is a chance to use woocommerce_get_country_locale hook:

      add_filter('woocommerce_get_country_locale', 'marcelbotezat_change_state_label_locale');
      function marcelbotezat_change_state_label_locale($locale){
          $locale['GB']['state']['label'] = __('somethingUK', 'woocommerce');
      	$locale['RO']['state']['label'] = __('somethingRO', 'woocommerce');
          $locale['US']['state']['label'] = __('anythingUS', 'woocommerce');
          return $locale;
      1. Excellent!

        1. The snippet code is

          add_filter( 'woocommerce_billing_fields' , 'bbloomer_rename_state_province', 9999 );
          function bbloomer_rename_state_province( $fields ) {
              $fields['billing_state']['label'] = 'State / Territory / Province';
              return $fields;
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 *