Address custom field

Overview

The address field enables users to select an address for the dynamic content item.

PREREQUISITES: The Address custom field is available only when you create dynamic content types. For more information, see Dynamic modules.

PREREQUISITES: If you want to use Geolocation API, you must use Microsoft SQL Server or SQL Server Express. Sitefinity CMS does not support geolocation when used together with Oracle and MySQL.

If you are using a database system that does not support Geolocation API, disable Geolocations in the following way:

  1. In the Sitefinity CMS backend, navigate to Administration » Settings » Advanced.
  2. In the treeview on the left, click GeoLocations » Providers » Default.
  3. Deselect the Enabled checkbox and save your changes.

Create an address custom field

To add an address field, perform the following:

  1. Perform procedure Create custom fields » Step 1 to Step 5.
  2. Enter the name of the address field.
    The name of the field is different from its label. The field's name serves as a reference for that field in the backend.
  3. In the Type dropdown box, select Address.
  4. If you select This is a hidden field checkbox, the custom field is not visible on the website or in the backend, and you can only use it in the code.
    IMPORTANT: Once you create a hidden field, you cannot edit its properties. Make sure you have configured all its properties before finishing creating it.
  5. In the Interface widget for entering data dropdown box, you select the widget that the content item editor will use to complete the field.
    The default widget is Address and map. You can configure how it behaves in step 9 below.
  6. Expand the Advanced section if you want to change the SQL database type of the custom field or the name of the column of the database table where the custom field is added.
    If you select the Allow empty values checkbox, the field is not required and can be left empty. If you deselect it, the field becomes mandatory.
  7. Click Continue.
    The Address Window opens.
  8. In the Label input field, enter the label of the textbox.
    For example, enter Home address.
  9. Select the method for entering the address by choosing one of the following:
Address form only When creating a dynamic item, you can enter the Country, the City, the Zip, and the Street.
Map only When creating a dynamic item, you can pinpoint the address on the world map.
Address form and map When creating a dynamic item, you can enter the Country, the City, the Zip, and the Street and also pinpoint the address on the world map.
  1. NOTE: To use a map for entering the address, you must set up Google Maps.
    For more information, see Set up Google maps.
  2. If you want to make the textbox mandatory, select This is a required field.
  3. Click Done.
    The new field appears in the Custom fields section.
    If you want to delete a custom field, click .
  4. Click Finish.

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Web Security for Sitefinity Administrators

The free standalone Web Security lesson teaches administrators how to protect your websites and Sitefinity instance from external threats. Learn to configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?