Published at: 2026-06-26
Dynamic Address
Dynamic Address Field Function \& Operation Guide
1. Function Overview
1.1 Function Introduction
The dynamic address field is an address input component that can automatically match the corresponding address format rules based on the country or region selected by the user. It dynamically adjusts the display order, names, and required attributes of address fields, enabling multi-country address entry to comply with local customs and compliance requirements.
1.2 Application Scenarios
-
Sales Personnel: When entering the address of a U.S. customer, simply select “United States”. The system will automatically replace “Province” with “State” and adjust the field order to “Street → City → State → ZIP Code”, avoiding entry errors caused by unfamiliarity with U.S. address formats.
-
Logistics Personnel: When processing EU orders that require addresses to meet EU customs clearance standards (Country Code + Postal Code + Complete Street Information), the dynamic address field automatically displays addresses in the German format: “Street → House Number → Postal Code → City”, ensuring smooth customs clearance of parcels.
-
Multinational Enterprise Managers: When using the system in Singapore (a city-state with no concept of “Province/State”), the dynamic address field automatically hides the provincial field and removes the mandatory requirement to fill in “N/A”, greatly optimizing the address filling experience.
2. Operation Guide
2.1 Function Entrance
Entrance: Admin Console → Object Management → Select Business Object → 【New Field】→ Select 【Dynamic Address】 as the field type
2.2 Create a New Dynamic Address Field
2.2.1 Sub-fields Included in Dynamic Address
The dynamic address field is a field group consisting of the following 16 sub-fields:
| Field Name | Field Type | Filter Support | Description |
|---|---|---|---|
| Country/Region | Single Selection | Yes | Triggers dynamic matching of address formats after selection |
| Address Format | Single Selection | Yes | Stores the address format applied to current data; optional values are enabled address formats under the selected country/region |
| State/Province | Single Selection | Yes | Associated with administrative division data |
| City | Single Selection | Yes | Associated with administrative division data |
| District/County | Single Selection | Yes | Associated with administrative division data |
| Township/Town | Single Selection | Yes | Associated with administrative division data |
| Village | Single Selection | Yes | Supports special customized processing as required |
| Detailed Address | Single-line Text | Yes | Detailed address description |
| Street | Single-line Text | Not supported temporarily | e.g. Street Address |
| Postal Code | Single-line Text | Yes | e.g. Postal Code / ZIP Code |
| Location | Location | Yes | Map positioning component |
| House Number | Single-line Text | Not supported temporarily | e.g. House Number |
| Building Name | Single-line Text | Not supported temporarily | e.g. Building Name |
| Room Number | Single-line Text | Not supported temporarily | e.g. Room / Suite Number |
| Floor | Single-line Text | Not supported temporarily | e.g. Floor Number |
| Formatted Address | Single-line Text | Yes | Automatically spliced and generated according to address format rules upon saving, mainly used for mailing scenarios |
2.2.2 Special Notes
-
Only one dynamic address field (including disabled fields) can be created for each object.
-
All sub-fields in the field group cannot be disabled separately in field configurations.
-
Each sub-field can be independently configured with field name, API Name, security level, prompt information and other attributes.
2.3 Upgrade Location Field to Dynamic Address Field
If the business object already has a preset 【Location】 field, it can be directly upgraded to a dynamic address field.
2.3.1 Operation Steps
-
Go to the 【Field Management】 page and find the location field to be upgraded.
-
Click Edit, and find the 【Dynamic Address】 switch in the upper right corner of the editing page.
-
Click the switch, and the system will pop up a secondary confirmation prompt: After enabling, this field will be converted to a 【Dynamic Address】 field by default, which can dynamically display address-related fields based on the selected country/region.This operation is irreversible. Please proceed with caution!
-
Click 【Confirm】 to complete the upgrade after verification.
2.3.2 Pre-upgrade Verification
The system will automatically check the following conditions during upgrade:
-
Upgrade is not allowed if any button uses this field as an input parameter. Please delete the relevant button configuration first as prompted.
-
Upgrade is not allowed if any layout rule uses this field as a control field. Please adjust the relevant layout rules first as prompted.
2.3.3 Post-upgrade Impacts
-
The original field name and field values remain unchanged.
-
Original field attributes such as default value and prompt information remain unchanged.
-
The field type is updated to “Dynamic Address”, with new fields added (e.g. Street, House Number, Formatted Address) that are not available in the original location field.
-
Existing layout rules, UI events and plugins configured based on country, province, city and other address fields remain effective normally.
-
The preset 【Mobile Number Attribution】 field on customer objects does not support this switch.
-
If the upgraded field is associated with a customer object, the corresponding fields on related objects need to be upgraded synchronously.
2.4 Address Entry Rules
2.4.1 Address Entry When Creating/Editing Data
1. Open the creation or editing page of data.
2. The dynamic address field displays Country/Region and Address Format on the first row by default.
3. After selecting a Country/Region, the system automatically matches the address format rules applicable to the selected country:
-
Dynamically adjust the display order and display names of address fields.
-
Example: When “United States” is selected, “Province” is automatically renamed to “State”, and all fields are arranged in compliance with U.S. address standards.
-
If multiple address formats are available for the selected country, the system selects the default format automatically, and users can manually switch to other formats.
4. Fill in each address field according to the system prompts and format rules.
5. Upon data saving, the system automatically generates the content of the 【Formatted Address】 field by splicing address information following the specified format rules.
2.4.2 Default Display of Initial Status
When the Country/Region field is empty (initial status on the creation page), the system matches the address format according to the following priority:
1. First Priority: Current user personal settings → Multi-region configuration → Address format of the corresponding country/region.
2. Second Priority: If personal settings are empty → Enterprise default region → Address format of the corresponding country/region.
3. Fallback Rule: If no valid configuration is found above, the preset international standard address format will be displayed.
If multiple address formats are matched, the default format will be displayed preferentially.
2.4.3 Detail Page Display
-
With valid dynamic address data: Display fields and field names in accordance with the address format corresponding to the country stored in the data. (e.g., if the U.S. format is selected during editing, the province, city, street and other fields on the detail page will be displayed in U.S. address format)
-
Without valid dynamic address data: Display address format based on the current user’s personal region configuration (priority) or the enterprise default region configuration.
2.4.4 List Page Display
All sub-fields (Country/Region, State/Province, City, Detailed Address, etc.) are independently displayed in separate columns on the list page, supporting column-based filtering and sorting.
2.5 Notes
1. Mandatory Address Format Configuration: The dynamic address field must be used with the 【Address Format】 backend management module. If no address format rule is configured for the target country/region, the frontend will prompt: “No available address format for the current country or region. Please contact the administrator to configure the address format and try again.”
2. Avoid Mixing Two Components: The dynamic address component and the original location component are two independent modules. The traditional location component can still be used for domestic business scenarios that do not require complex address formatting.
3. Import \& Export: Support creation import, update import and data export. The system does not verify required field rules defined in address formats during data import.
4. OpenAPI \& Function-based Data Creation: When creating data via OpenAPI or custom functions, the system does not verify the display, hiding and required logic of address format fields.
5. Button Input Parameters: In the button input parameter popup, the dynamic address field is presented as a complete field group, with each internal sub-field displayed in an independent column. Required attributes can only be configured for the entire field group instead of individual sub-fields.
6. Address Format Changes Do Not Affect Historical Data: Any edits to address format rules by administrators only apply to newly created data. All existing historical data remains unchanged.
3. Frequently Asked Questions
Q1: What are the differences between the dynamic address component and the original location component? Which one should be used?
The location component is applicable to enterprises or business modules without international business scenarios, which only require simple selection of country, province, city and district. The dynamic address component is designed for enterprises with international business, which requires adaptive address formats for different countries. The two components can coexist in the same system and can be selected according to actual business needs.
Q2: Why does the dynamic address component not display fields as expected after a country is selected?
Please check whether address format rules have been configured for the selected country in the admin console, and confirm whether there are enabled address formats for this country.
Q3: Can multiple dynamic address fields be created for a single object?
No. Each object supports a maximum of one dynamic address field (including disabled fields). If multiple address fields are required (e.g., shipping address and billing address), please submit a special application.
Q4: Can the upgrade to dynamic address field be reverted?
No. The upgrade operation is irreversible. Please confirm business requirements before upgrading. After the upgrade, the original field name and existing data will not be affected.
Q5: How is the content of the formatted address field generated?
The formatted address is automatically generated upon data saving based on the text splicing format configured in the address format rules, including field prefixes, suffixes, separators and other splicing logic. This field is not displayed or editable on the data creation and editing pages.