Expand 2-letter US state codes (e.g. NJ) to full state names (e.g. New Jersey) in Gravity Forms Address merge tags.

izzy goldman

<p><strong>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>
<p>This causes real problems with:</p>
<ul>
<li>Notification emails that read “Your shipment is going to NJ.”</li>
<li><code>{all_fields}</code> output mixing full city names with state codes.</li>
<li>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.</li>
</ul>
<h4>The Solution</h4>
<p>This plugin hooks into <code>gform_merge_tag_filter</code> and, <strong>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>
<h4>Key Features</h4>
<ul>
<li><strong>Targeted</strong> — Only affects Address field State sub-inputs (X.4), nothing else</li>
<li><strong>Safe</strong> — Only acts when the value is exactly two letters; existing full names and other text pass through untouched</li>
<li><strong>Zero Configuration</strong> — Activate the plugin and the fix is live</li>
<li><strong>Filterable</strong> — Override or extend the code-to-name map with the <code>fsn_gf_state_map</code> filter for non-US addresses or translated labels</li>
<li><strong>Filterable expansion</strong> — Hook <code>fsn_gf_expanded_state_name</code> to customize the replacement on a per-field basis</li>
</ul>
<h4>Where It Applies</h4>
<ul>
<li><code>{all_fields}</code> merge tag</li>
<li><code>{Address (State / Province):X.4}</code> merge tag</li>
<li>Notifications, confirmations, and any place merge tags are processed</li>
<li>URL query strings built with merge tags (so the receiving form’s state dropdown picks the correct option)</li>
</ul>
<h4>Covered Codes</h4>
<p>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.</p>


Alternatives to Full State Name for Gravity Forms

Top alternatives