{"id":10819,"date":"2026-05-21T00:29:49","date_gmt":"2026-05-20T16:29:49","guid":{"rendered":"https:\/\/aeosub.com\/full-state-name-for-gravity-forms\/"},"modified":"2026-05-21T00:29:49","modified_gmt":"2026-05-20T16:29:49","slug":"full-state-name-for-gravity-forms","status":"publish","type":"post","link":"https:\/\/aeosub.com\/zh\/full-state-name-for-gravity-forms\/","title":{"rendered":"Full State Name for Gravity Forms"},"content":{"rendered":"
\"Full<\/div>\n
\n\n\n\n\n\n\n\n
Developer<\/th>\nizzy goldman<\/a><\/td>\n<\/tr>\n
Version<\/th>\nv1.0.1<\/td>\n<\/tr>\n
Active Installs<\/th>\n0 +<\/td>\n<\/tr>\n
Requires \/ Tested<\/th>\n5.8 \/ 6.9.4<\/td>\n<\/tr>\n
Last Updated<\/th>\n2026-05-20 4:27pm GMT<\/td>\n<\/tr>\n
Official Link<\/th>\nView Details \u2192<\/a><\/td>\n<\/tr>\n<\/table><\/div>\n
Expand 2-letter US state codes (e.g. NJ) to full state names (e.g. New Jersey) in Gravity Forms Address merge tags.<\/div>\n

Full State Name for Gravity Forms<\/strong> fixes an annoying inconsistency in Gravity Forms: depending on the form, the add-on, and the code path, the Address field’s “State \/ Province” sub-input (input X.4) sometimes resolves to a 2-letter abbreviation (“NJ”) and sometimes to the full state name (“New Jersey”) when used in merge tags.<\/p>\n

This causes real problems with:<\/p>\n

    \n
  • Notification emails that read “Your shipment is going to NJ.”<\/li>\n
  • {all_fields}<\/code> output mixing full city names with state codes.<\/li>\n
  • URL query strings that pre-populate another Gravity Form \u2014 the second form’s state dropdown doesn’t match “NJ” against its option value of “New Jersey”, so the field stays blank.<\/li>\n<\/ul>\n

    The Solution<\/h4>\n

    This plugin hooks into gform_merge_tag_filter<\/code> and, only when the merge tag targets an Address field’s State sub-input (X.4) and the value is exactly a 2-letter code<\/strong>, expands it back to the full state name that Gravity Forms uses in its Address field dropdown.<\/p>\n

    Key Features<\/h4>\n
      \n
    • Targeted<\/strong> \u2014 Only affects Address field State sub-inputs (X.4), nothing else<\/li>\n
    • Safe<\/strong> \u2014 Only acts when the value is exactly two letters; existing full names and other text pass through untouched<\/li>\n
    • Zero Configuration<\/strong> \u2014 Activate the plugin and the fix is live<\/li>\n
    • Filterable<\/strong> \u2014 Override or extend the code-to-name map with the fsn_gf_state_map<\/code> filter for non-US addresses or translated labels<\/li>\n
    • Filterable expansion<\/strong> \u2014 Hook fsn_gf_expanded_state_name<\/code> to customize the replacement on a per-field basis<\/li>\n<\/ul>\n

      Where It Applies<\/h4>\n
        \n
      • {all_fields}<\/code> merge tag<\/li>\n
      • {Address (State \/ Province):X.4}<\/code> merge tag<\/li>\n
      • Notifications, confirmations, and any place merge tags are processed<\/li>\n
      • URL query strings built with merge tags (so the receiving form’s state dropdown picks the correct option)<\/li>\n<\/ul>\n

        Covered Codes<\/h4>\n

        All US states (50), DC, US territories (PR, GU, VI, AS, MP), and military mailing regions (AA, AE, AP) \u2014 a total of 59 entries that match the default Gravity Forms Address state options exactly.<\/p>","protected":false},"excerpt":{"rendered":"

        Expand 2-letter US state codes (e.g. NJ) to full state names (e.g. New Jersey) in Gravity Forms Address merge tags.<\/p>","protected":false},"author":1,"featured_media":9317,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[252],"tags":[1535,1536,1537,571,1538,555],"class_list":["post-10819","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-trends","tag-address-field","tag-gravity-forms","tag-merge-tags","tag-notifications","tag-state-name","tag-wordpress-plugin"],"_links":{"self":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts\/10819","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/comments?post=10819"}],"version-history":[{"count":0,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts\/10819\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/media\/9317"}],"wp:attachment":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/media?parent=10819"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/categories?post=10819"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/tags?post=10819"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}