How can we help you?

The Gravity Forms Auto Populate Country, State, City & Ward Add-On provides high-speed, cascading dropdowns for geographic administrative divisions worldwide. Eliminate user frustration, standardize address data, and automatically filter states, cities, districts, wards, and postal codes based on the preceding geographic selection—powered by a local database with zero external API fees.

Core Capabilities & Cascading Database Architecture

Traditional address forms rely on unlinked text fields where users frequently misspell city names, enter obsolete postal codes, or select invalid states. The Auto Populate Country, State, City & Ward addon introduces dynamic cascading logic: selecting a Country immediately filters the State/Province dropdown; selecting a State immediately populates the City dropdown; and in supported regions (such as Vietnam, Japan, and Southeast Asia), selecting a City dynamically populates District and Ward/Commune dropdowns.

Because the geographic hierarchy is queried directly from indexed WordPress database tables using lightweight AJAX endpoints, lookups execute in milliseconds with zero reliance on external third-party rate limits or metered billing.

Step 1: Installation & Commercial License Activation

Download the plugin ZIP file from your Gravity Extra customer portal. In your WordPress admin dashboard, navigate to Plugins → Add New → Upload Plugin, select the gravityextra-gf-auto-populate-country-state-city-ward-addon.zip file, and click Install Now followed by Activate Plugin.

After activating, open Forms → Settings → Auto Populate Country/State/City/Ward to activate your commercial license key for automatic updates and technical support.

Step 2: Adding the Cascading Geographic Field to Your Form

Open the form editor for your target form. In the right-hand field toolbox under Advanced Fields, drag the Country/State/City/Ward field onto your form canvas.

Step 3: Configuring Cascading Dropdown Hierarchy

In the field settings panel, define how many levels of geographic depth you wish to display:

1. Selecting Active Geographic Tiers

Choose which levels are required for your form:

• 2-Level Hierarchy: Country → State / Province.
• 3-Level Hierarchy: Country → State → City.
• 4-Level Extended Hierarchy: Country → State → City → Ward / District.

Step 4: Default Values, Single-Country Mode & IP Geolocation

1. Default Country Selection

If the majority of your customers originate from a specific nation, set that country as the default selected option to speed up form completion.

2. Single Country Lockdown Mode

For strictly domestic businesses (e.g., local home delivery or municipal services), lock the form to a single country. The Country field automatically fixes to your target nation and immediately displays the appropriate states and cities.

3. Automatic IP Geolocation Detection

Enable the Detect User’s Country by IP toggle. The add-on analyzes the visitor’s IP address upon page render and automatically pre-populates their country of origin.

4. Multi-Country Whitelisting

If your organization only services select international markets, configure a multi-country whitelist. Only designated nations will appear in the primary dropdown menu.

Step 5: Managing Custom Locations & Fallback Text Input

1. Database Management & Custom Administrative Divisions

Need to add newly established municipalities, private industrial parks, or custom delivery zones? Use the built-in location manager to add, edit, or remove entries directly.

2. Fallback Custom Text Input Setting

Enable the Allow custom input if data not found toggle. If a user cannot find their specific locality, a clean text input appears allowing them to type their location manually.

Step 6: Frontend Searchable Select & Postal Code Matching

Enhance the frontend user experience with modern searchable select elements and automatic postal code resolution:

Step 7: Conditional Logic, Internationalization & Entry Storage

Seamlessly integrate cascading geographic selections with Gravity Forms conditional logic and multi-language sites:

Troubleshooting & Common Issues

Issue Encountered	Probable Cause	Recommended Resolution
State dropdown remains empty after Country selected	Database tables missing or WordPress AJAX blocked by firewall.	Go to Forms → Settings → Auto Populate and click Rebuild Database Tables. Verify admin-ajax.php is not blocked.
Dropdown styles look unstyled or misaligned	Theme CSS overriding standard Select2 / TomSelect styles.	Enable the Enforce Add-on CSS toggle in field appearance settings.
Large country packs timing out during import	PHP max_execution_time or memory limit reached.	Increase PHP memory to 256M and execution time to 120s in php.ini, or import countries individually.

Frequently Asked Questions (FAQ)