Do not sell or share my personal information Skip to content

Add or modify states

Add this code to your child theme’s functions.php file or via a plugin that allows custom functions to be added, such as the Code Snippets plugin. Avoid adding custom code directly to your parent theme’s functions.php file, as this will be wiped entirely when you update the theme.

Add your own or modify shipping states in WooCommerce.

Note: you must replace both instances of XX with your country code. This means each state id in the array must have your two letter country code before the number you assign to the state.

		if ( ! function_exists( 'YOUR_PREFIX_add_or_modify_states' ) ) {
   * Add or modify States
   * @param array $states Existing country states.
   * @return array $states Modified country states.
  function YOUR_PREFIX_add_or_modify_states( $states ) {
    $states['XX'] = array(
      'XX1' => __( 'State 1', 'YOUR-TEXTDOMAIN' ),
      'XX2' => __( 'State 2', 'YOUR-TEXTDOMAIN' ),

    return $states;
  add_filter( 'woocommerce_states', 'YOUR_PREFIX_add_or_modify_states' );


Last updated: February 07, 2024