Address and Location Fields

WittyForm provides several specialized fields for collecting location data, addresses, and social profile information. Each field is designed for a specific type of input and includes validation and formatting to ensure clean, usable data in your responses.

Address Field

The address field collects a complete mailing address in a structured, multi-line format. It breaks the address into individual components so you get clean, standardized data instead of a single free-text string.

Components

The address field includes these sub-fields:

• Street address — Line 1 for the street number and name.
• Street address line 2 (optional) — For apartment, suite, or unit numbers.
• City — City or town name.
• State / Province / Region — Adapts its label based on the selected country.
• ZIP / Postal code — Validates the format based on the selected country.
• Country — A dropdown with all countries. You can set a default country or restrict the list to specific countries.

Auto-complete

The address field supports browser auto-complete, so respondents who have their address saved in their browser can fill in the entire address with a single click. WittyForm uses standard HTML autocomplete attributes to enable this.

Configuration

• Default country — Pre-select the country dropdown to the most common country for your audience.
• Hide line 2 — Remove the second street address line if you do not need it.
• Restrict countries — Limit the country dropdown to specific countries relevant to your use case.
• Required — Make all address components mandatory.

Data Format

In responses, address data is stored as a structured object with separate fields for each component. When exported to CSV, each component gets its own column (street, city, state, zip, country), making it easy to import into mailing list tools or CRM systems.

Geolocation Field

The geolocation field captures the respondent’s GPS coordinates directly from their device. It is useful for field surveys, delivery forms, and any situation where you need to know the respondent’s exact location when they submit the form.

How It Works

When the respondent reaches the geolocation field, their browser requests permission to access their location. If they grant permission, the field captures their latitude and longitude. A small map preview shows the detected location so the respondent can verify it is correct.

If the respondent denies the location permission, the field shows a message explaining that location access is needed. You can configure what happens in this case: either the field becomes optional or the respondent can manually enter an address as a fallback.

Configuration

• Map display — Show or hide the map preview that displays the detected location.
• Accuracy — Choose between high accuracy (uses GPS on mobile, slower but more precise) or balanced accuracy (uses network-based location, faster but less precise).
• Fallback — Allow respondents to manually enter a location if GPS is unavailable or denied.

Data Format

Geolocation data is stored as latitude and longitude coordinates (e.g., 40.7128, -74.0060). In exports, these appear as two separate columns. You can use these coordinates with mapping tools and location-based analytics.

Country Selector

The country selector is a standalone dropdown field for selecting one or more countries. It is simpler than the full address field when you only need to know the respondent’s country.

Configuration

• Flag icons — Toggle the display of country flag icons next to each country name for visual recognition.
• Multi-select — Allow respondents to select multiple countries (useful for questions like “Which countries have you visited?”).
• Default country — Pre-select a country based on your audience.
• Searchable — Enabled by default. Respondents can type to filter the list instead of scrolling through all countries.
• Restrict list — Show only specific countries in the dropdown.

Data Format

Country selections are stored using the ISO 3166-1 country code (e.g., “US” for United States, “GB” for United Kingdom) along with the full country name. Multi-select values are stored as an array.

Social Links

The social links field collects URLs for social media profiles and websites. It provides dedicated input rows for each platform with appropriate icons, validation, and placeholder text.

Supported Platforms

• Twitter / X — Validates twitter.com or x.com URLs, or accepts @username format.
• LinkedIn — Validates linkedin.com profile URLs.
• Instagram — Validates instagram.com URLs or accepts @username.
• Facebook — Validates facebook.com profile or page URLs.
• YouTube — Validates youtube.com channel or user URLs.
• TikTok — Validates tiktok.com profile URLs.
• GitHub — Validates github.com profile URLs.
• Website — Accepts any valid URL for a personal or business website.

Configuration

• Platforms — Choose which platforms to show. You can enable any combination of the supported platforms.
• Required platforms — Optionally make specific platforms required while leaving others optional.

Validation

Each platform input validates that the entered URL matches the expected format for that platform. If a respondent enters an invalid URL, they see a specific error message (e.g., “Please enter a valid LinkedIn profile URL”). The validation is lenient enough to accept common URL formats including with and without “www” or trailing slashes.

Data Format

Social link data is stored as an object with a key for each platform and the URL as the value. In CSV exports, each platform gets its own column.

Best Practices

• Use the full address field when you need a complete mailing address. Use the country selector when you only need the country.
• Set a default country on address and country fields to speed up form completion for your primary audience.
• Only use the geolocation field when the respondent’s physical location is genuinely needed. Requesting location access can feel intrusive and may cause respondents to abandon the form.
• For the social links field, only enable the platforms that are relevant to your use case. Showing too many platform options can overwhelm respondents.
• Add help text to location fields explaining why you need the data and how it will be used. This builds trust and improves completion rates.