- 2026-05-21
- by LethaldiranMX
- Trends
- 0 Comments
DeveloperExpand 2-letter US state codes (e.g. NJ) to full state names (e.g. New Jersey) in Gravity Forms Address merge tags.
Full State Name for Gravity Forms 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.
This causes real problems with:
- Notification emails that read “Your shipment is going to NJ.”
{all_fields}output mixing full city names with state codes.- URL query strings that pre-populate another Gravity Form — the second form’s state dropdown doesn’t match “NJ” against its option value of “New Jersey”, so the field stays blank.
The Solution
This plugin hooks into gform_merge_tag_filter 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, expands it back to the full state name that Gravity Forms uses in its Address field dropdown.
Key Features
- Targeted — Only affects Address field State sub-inputs (X.4), nothing else
- Safe — Only acts when the value is exactly two letters; existing full names and other text pass through untouched
- Zero Configuration — Activate the plugin and the fix is live
- Filterable — Override or extend the code-to-name map with the
fsn_gf_state_mapfilter for non-US addresses or translated labels - Filterable expansion — Hook
fsn_gf_expanded_state_nameto customize the replacement on a per-field basis
Where It Applies
{all_fields}merge tag{Address (State / Province):X.4}merge tag- Notifications, confirmations, and any place merge tags are processed
- URL query strings built with merge tags (so the receiving form’s state dropdown picks the correct option)
Covered Codes
All US states (50), DC, US territories (PR, GU, VI, AS, MP), and military mailing regions (AA, AE, AP) — a total of 59 entries that match the default Gravity Forms Address state options exactly.
