📚 Part of the series Application Building Phase II: The Slate-hosted Application

You can use a custom Address Block to map to multiple custom fields and store address related data. The following example will walk through creating and mapping custom birth location fields.

Creating Custom Address Fields

1. Click Database in the top navigation bar and select Fields.

2. Click New Field to begin creating a custom field.

3. Create three new custom fields will need to be created to store this data. The naming convention for these fields must all be consistent in using the same prefix. Each field ID should be computer-friendly (no spaces, capital letters, or special characters other than an underscore). These fields will need to collect city, country and region, so example field IDs for a set of birth location fields could be:

   • birth_city

   • birth_country

   • birth_region

4. Set the appropriate Scope for the data being collected. For this example, birth location fields should be Person-scoped.

5. Pay close attention to the Field Type setting for each field.

   • The City field should use a Field Type of Free Text.

   • The Country field should use a Field Type of Single Value, and select the pre-built country prompt.

   • The Region field should use a Field Type of Single Value, and select the pre-built state prompt.

Configuring the Address Block on a Form

1. Navigate to the Forms tool in the top navigation bar.

2. Create a new form or select an existing form.

3. Click Edit Form in the right-hand side menu.

4. Drag in a Location widget onto the form from the form fields palette.

5. In the Type dropdown, select the appropriate type based on how much address data is being collected. For this example, we will select Location (No Postal Code) to collect city, country, and region.

6. Enter a name within the Label field, such as Birth Location.

7. Leave the System Field dropdown blank.

8. Within the Export Key setting, manually enter the export key to link the address widget with the new custom fields. For this example with person-scoped fields, the export key would be sys:field:birth . (For application-scoped fields, the export key would be sys:app:birth.)

9. Click Save.