Overview

The Address Field in Zoho CRM is designed to make capturing and using address data easier, structured, and more reliable. Instead of scattering location details across multiple fields or using one long text box, you get a single, compound field that neatly organizes each part of the address. This makes it easier for users to enter data and far more useful for reporting, filtering, automation, and territory planning.

​

The Address Field gives you everything stored under one compound field, but still broken down into smaller components like country, state, and postal code. Each part can still be viewed, used, and updated individually when needed.

Why this matters

Address data isn’t just stored for reference. Sales, support, logistics, and marketing teams use it for real work every day:

• Sales teams may divide territories by state or country
• Logistics teams may plan deliveries by postal code or region
• Marketing teams can run location-based campaigns
• Field reps can use latitude and longitude to plan routes or visits

Having all of this in one structured, reliable field saves hours of setup, avoids duplicate values or spelling errors, and makes territory-based work faster.

Availability and limits

• Supported Editions: Professional, Enterprise, Ultimate.
• Supported Modules: All modules except User Modules, Linking Modules, and activity modules like Tasks, Calls, and Meetings.
• Limit: You can add up to two custom Address Fields per module.
  

Working with an Address Field

Adding an Address Field

The Address Field is a compound field. Eight different sub-fields are grouped together into a single address field in the layouts:

• Country/ Region
• Flat/ House No/ Building/ Apartment Name
• Street Address
• City
• State/ Province
• Zip/ Postal Code
• Coordinates (Latitude & Longitude)

These pieces work together as one address.

To add an address field into your layout,

1. Go to Setup > Customization > Modules and Fields.
2. Select the module you want to customize and open the layout editor.
3. Drag the Address Field from the field tray into the layout.
   
4. On the Address Properties pop-up:

1. Set the field name.
2. Choose whether you need Flat/House No/Building/Apartment Name field in the Address.
3. Select a default country from the dropdown if preferred.
4. Select the other options for marking the field as public and/or to show tooltip.

5. Click Done.
6. Save the layout.

Once saved, the field will appear in all the places for record creation, edit forms, quick create, clone, and record details.

Field Permissions

• You can assign access permissions to the entire Address Field based on users’ profiles.
  
• At the individual sub-field level, permission settings are not available. However, you can still mark each sub-field as mandatory or optional, depending on your data requirements.
  

Using Address Field on Records

• On the record creation pages, the Address Field appears as one grouped section with expandable sub-fields.
• On the record detail pages, it appears as a neatly formatted block. Users can click the pencil icon to update the address, where all sub-fields are editable in a pop-up.

​​

Using address details across CRM

The Address Field is more than just a structured input box. The details from the subfields can be used across CRM for filtering, adding criteria, and viewing records. 

• Filters & Criteria: You can apply address-based criteria in any filter or condition across modules—such as Smart Filters, or criteria in views, and criteria in reports, automation, process management, or any area where conditions are required. Users can choose any part of the address field such as Country, State, or City, to define precise conditions.
  
  For example, you might create a Smart Filter for Country = India or City = Chennai.
  
  Similarly, you can build a custom view to list leads from Chennai or Coimbatore in Tamil Nadu, helping regional teams focus on location-specific follow-ups.
  
  
• Views: In any view where records are displayed, List View, Kanban View, Grid View, Reports, Dashboards, or Related Lists, users can choose to show address details. From the Manage Columns option, you can either display the full Address field or add only specific parts like City, Country, or Postal Code.
  
  A territory manager, for example, can enable fields like City, State/Province, and Street Address in the Contacts list view to quickly identify where customers are located and plan visits without opening each record.
  
  

Managing country and state values

One of the biggest benefits of the Address Field is that it comes with ready-made global sets of countries and their states. This means users don't have to type in location names manually or depend on admins to set up endless dependency rules. When someone chooses a country, the states are instantly filtered and displayed. This avoids spelling mistakes, keeps entries consistent, and ensures your reports don’t end up with duplicate variations like “New York” and “NY.”

If your business works in specific regions, you can also control the list. For example, you might only want to show a limited set of countries where you operate, or add custom state values for regions you serve. This flexibility is handled through Global Sets in Setup.

To configure country and state values:

1. Go to Setup > Customization > Global Sets.
2. Open the set for Countries and States.
   
3. Click Configure to add, remove, or edit the values to suit your business needs.
4. Click Save.

Once configured, these values automatically appear in every Address Field across your CRM.

Controlling how invalid entries are handled

When configuring the country and state list, you can also control whether CRM should accept only the values you’ve configured, and how to handle invalid entries. 

1. Go to Setup > Customization > Global Sets.
2. Open the set for Countries and States.
3. Click Address Update Preference.
   
4. On the Address Update Preference pop-up:

1. Select the checkbox if you want to allow only configured countries and states
   into the CRM.
   
2. Additionally, choose how to handle invalid entries

1. Skip invalid entries and save the record–CRM ignores the invalid country/state value but still creates or updates the record with the remaining details.
2. Stop the record save/update–CRM blocks the entire action until the invalid values are corrected, keeping your data fully consistent.
   Note: Record creation or updates will be restricted starting from API version V9. For versions below V9, the selected option will have no impact.

Points to be noted:

• Verifying address while updating
  When updating any individual sub-field of the Address Field, ensure that the entire address remains valid. If any dependent fields are affected, verify and update them as needed.

• Valid coordinate range

1. Latitude: Must be between -90 and +90

2. Longitude: Must be between -180 and +180
   Only values within these limits will be accepted. If an invalid value is entered, the update will fail.

• Using Country/Region and State/Province codes

1. You can use Country/Region code and State/Province code to update address values.

2. If both Country/Region and State/Province need to be updated, enter the corresponding codes for each.

3. If only the State/Province needs to be updated, the State/Province code must be provided along with the Country/Region code. Without both, the state or province will not be updated.

4. If the Country/Region is updated, any existing State/Province will remain only if it belongs to the updated country/region. Otherwise, it will be removed.

• Areas where Address Field is not supported

1. Webforms

2. Field updates in Actions

3. Merge fields for these address sub-fields in the Create Record actions of automation and process management features