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
 * @donate $9     https://businessbloomer.com/bloomer-armada/
 */

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 PHP snippets at the bottom of your child theme functions.php file and CSS at the bottom of its 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 guide "Should I Add Custom Code Via WP Editor, FTP or Code Snippets?" and my video tutorial "Where to Place WooCommerce Customization?"

Does this snippet (still) work?

Please let me know in the comments if everything went 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.

If you think this code saved you time & money, feel free to join 17,000+ WooCommerce Weekly subscribers for blog post updates and 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.

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?
    Thanks

    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.
    Thanks

  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? Support? Leave your Comment Now!
_____

If you are writing code, please wrap it between shortcodes: [php]code_here[/php]. Failure to complying with this (as well as going off topic, not writing in English, etc.) will result in comment deletion. 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 BloomerArmada to get blog comment reply priority, ask me 1-to-1 WooCommerce questions and enjoy many more perks. Thank you :)

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