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        businessbloomer.com/woocommerce-customization
 * @author        Rodolfo Melogli, Business Bloomer
 * @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

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