Address Fields
Add complete address fields with street, city, state, zip, and country. Capture full address information in a structured format.
Important: Create Fields in QuickBase First
Before adding address fields to your SyncForms form, you must create them in your QuickBase table first.Address fields are composite fields that consist of 6 consecutive sub-fields in QuickBase: Street Address, Street Address 2, City, State/Region, Postal Code, and Country. All 6 sub-fields must be created in QuickBase in consecutive order before the address field can be used in SyncForms. Once created in QuickBase, the address field will appear in the "Add Field" list when building your form.
Overview
Address fields capture complete address information in a structured format. They consist of 6 sub-fields that work together to collect street address, city, state, postal code, and country. Address fields provide a consistent way to capture location data and can include dropdown options for state and country selection.
Address Sub-Fields
Address fields consist of 6 sub-fields that must be created consecutively in QuickBase. Each sub-field captures a specific part of the address.
Sub-Field Structure:
- 1Street Address (Street 1): Primary street address line
- 2Street Address 2 (Street 2): Optional secondary address line (apartment, suite, etc.)
- 3City: City or locality name
- 4State/Region: State, province, or region (can be dropdown with US states)
- 5Postal Code: ZIP code, postal code, or postal district
- 6Country: Country name (can be dropdown with country options)
QuickBase Setup
Address fields require specific setup in QuickBase. The main address field and all 6 sub-fields must be created in consecutive order for SyncForms to recognize them as a complete address field.
Step-by-Step QuickBase Setup:
- 1In QuickBase, create an Address field in your table
- 2QuickBase will automatically create 6 consecutive sub-fields after the address field
- 3Configure each sub-field with appropriate labels (Street Address, City, State, etc.)
- 4For State and Country sub-fields, you can optionally add choice options to create dropdowns
- 5Ensure all 6 sub-fields have consecutive field IDs (e.g., if address field is ID 10, sub-fields should be 11, 12, 13, 14, 15, 16)
- 6Save all fields in QuickBase
- 7In SyncForms, the address field will appear as a single field with all 6 sub-fields grouped together
Important: The 6 sub-fields must be consecutive in QuickBase. If there are gaps in the field IDs, SyncForms may not recognize all sub-fields correctly. QuickBase typically creates these automatically when you create an Address field.
State & Country Dropdowns
State and Country sub-fields can be configured as dropdowns in QuickBase. SyncForms automatically provides a built-in US states dropdown for the State field, and you can configure country options in QuickBase.
State Field:
- SyncForms automatically provides a dropdown with all 50 US states
- Users can select a state abbreviation (e.g., "CA"), which is automatically converted to the full state name (e.g., "California")
- If you configure state choices in QuickBase, those will be used instead of the built-in list
Country Field:
- To create a country dropdown, add choice options to the Country sub-field in QuickBase
- Add country names as choices (e.g., "United States", "Canada", "United Kingdom")
- If no choices are configured, the country field will be a text input
Adding Address Fields to Your Form
The process for adding address fields is the same as other fields - they must exist in QuickBase first with all 6 sub-fields.
Step-by-Step:
- 1Create field in QuickBase: Create the Address field with all 6 consecutive sub-fields in your QuickBase table
- 2Open your form in the Form Builder
- 3Click Add Field and select your QuickBase address field
- 4SyncForms will automatically detect all 6 sub-fields and display them as a grouped address field
- 5Click the field to customize label, required status, and other settings
Field Configuration
Customize how address fields appear and behave in your form.
Configuration Options:
- Label: Customize the field label (defaults to QuickBase field name)
- Required: Make the entire address field mandatory (inherits from QuickBase if set there)
- Help Text: Add descriptive text below the field to guide users
- Sub-Field Labels: Sub-field labels come from QuickBase and can be customized there
📍 Address Data Structure:
Address fields store data as a structured object with all 6 sub-fields. When submitted to QuickBase, each sub-field value is sent to its corresponding QuickBase field ID. This ensures that address data is properly stored and can be used for mapping, reporting, and other QuickBase features.
Best Practices
- Use Dropdowns for State/Country: Configure state and country sub-fields as dropdowns in QuickBase to ensure consistent data entry and reduce errors.
- Clear Labels: Use descriptive labels for the address field and ensure sub-field labels in QuickBase are clear (e.g., "Street Address" not just "Address").
- Required Fields: Mark address fields as required when location information is essential for the form submission.
- Help Text: Add help text to clarify address format requirements, especially for international addresses or specific postal code formats.