An Address field holds a street address, with Google Maps filling in the parts as you type. Think of a vendor's mailing address, written once and pinned on a map.
Here is the test: is the answer a place with a street, city and country? If yes, you want an Address field. For a web address, use a Link field; for a region picked from a fixed list, use a Single Select field.
Example: a Vendors table with a field called Headquarters. Each vendor's address is picked from the Google suggestions, so it is complete and sits on the map. A view grouped by country shows where customer data may travel.
The Headquarters field in a vendor record, showing a validated address on multiple lines with the map preview under it.
Plan Availability | All plan types. |
Permissions | Solution Managers and Workspace Administrators can create, modify and manage Address fields. |
Platform | Web |
Related Reading |
Adding an Address Field Type
In Grid View, select the + at the right end of the column headers. From an open record, select + Add new field to this Table at the bottom instead.
Select Address. You can type to search the list of field types.
Name the field. In this article it is Headquarters. A field name can hold up to 50 characters, and there is no restriction on the characters it can contain.
The field settings panel opens. It has three tabs: Settings, AI Field Agent and Help Text. There is no Defaults tab. The rest of this article takes them in that order. Save at any point with Add Field (or Update Field on a field that already exists) and come back to the other tabs later.
The field settings panel, Settings tab, with the Display Format toggle, the sample address with its map preview and the two Options switches.
Settings
The Settings tab holds how the address is laid out and two rules. Top to bottom: Display Format and Options.
Display Format
How the address is shown in a record. A sample address previews the choice, with a map under it.
Multiple Line (the default): each part on its own row, labeled Street, Suite / Apt / Bldg, City, State / Region, Postal Code and Country.
Single Line: one comma-separated line.
Headquarters uses Multiple Line, so each part is easy to check against the vendor's contract. Use Single Line where the record is crowded and the address is read more than edited.
Options
Two switches. Each one is a rule for the people who fill in records.
Include Map Display. On by default. On, a map with a marker shows under the address in the record once the address was picked from the Google suggestions. It does not affect Map View.
Require an entry in this field. Off by default. On, a record cannot be saved until an address is entered. Turn it on when a blank means something is missing. A vendor with no headquarters is a vendor nobody has checked.
Note: Include Map Display controls the map preview under the field in a record only. Map View is unaffected, and it still needs an address picked from the suggestions.
The Options switches, Include Map Display on and Require an entry in this field off.
AI Field Agent
Off by default. The field works fully without it. Turn it on to let SmartSuite AI fill the address from instructions you write.
Connection: the AI credential the field uses. The field cannot be saved with the agent on until one is chosen.
Instructions: what you want the agent to do, in plain words, with at least one field from the record inserted as a variable.
Run Automatically: on, the agent runs each time the record is updated; off, it runs when you ask.
An instruction must include at least one field from the record, inserted as a chip from the blue + picker, so the agent reads that field's value. Example for Headquarters, with the Vendor Legal Name and Registered Address Text fields inserted as chips (shown here in bold). The instruction reads: "Using Vendor Legal Name and Registered Address Text, write the vendor's headquarters address as street, city, state or region, postal code and country. If the text holds no address, leave the field empty." A person still checks the address and picks it from the suggestions if it must show on the map. The AI Field Agent article covers connections and instructions in full.
The AI Field Agent tab turned on, with a connection, the instruction for Headquarters showing the Vendor Legal Name and Registered Address Text chips, and Run Automatically.
Help Text
A note for the person filling in the record, up to 800 characters. Help Text Appearance shows it As A Tooltip (the default, behind an info icon next to the field name) or Below The Field Name (always visible).
Write it for someone who has never seen the field. For Headquarters: "Start typing and pick the address from the list, so it shows on the map. Use the registered office, not a sales office."
Permissions
Field Permissions. Every field can carry its own permissions, which control who can see the field and who can edit it. Open the column menu and select Edit Field Permissions. Let Procurement edit Headquarters while everyone else reads it. See Field Permissions.
Dynamic Record Permissions. An Address field can also drive record-level rules: who can see or edit a record based on the value it holds. Every field type except Button can drive a rule. See Dynamic Record Permissions.
Using the field in views and records
In a record, the field is six boxes: Street, Suite / Apt / Bldg (optional), City, State / Region, Postal Code and a Country dropdown. In Grid View, select the cell and press Enter to open the same rows in an entry form with Cancel and Done. Type in Street and Google suggests matches as you type. Pick one and City, State / Region, Postal Code and Country fill in. The grid cell then shows a pin icon and the street. An address picked this way counts as validated. It gets a map position, appears in Map View, and shows a map preview under the field when Include Map Display is on. An address typed without picking a suggestion is saved as typed, with no check and no map position. See Map View.
Note: Only an address picked from the Google suggestions is validated and shown in Map View. A typed address is stored as typed and stays off the map.
Filtering
The operators are is, is not, contains, does not contain, is empty and is not empty. A filter can target one component, such as the country: "Headquarters country is not United States" lists the vendors whose head office is abroad.
Grouping
Group a view by the field and choose a component: street, city, state, zip code or country. Vendors grouped by the country of Headquarters show at a glance which ones sit outside your data residency zone.
Tip: Group by country or state for a data residency or regional review. Each group lists its vendors with a count, so the review starts from the view.
Sorting
Sort A → Z or Z → A from the column menu. A view can sort by the whole address or by any one component, such as the city or the country.
Counting and rolling up
A Lookup field shows the full address on a linked record. A Rollup cannot read an Address field; a Rollup combines number fields only. See Lookup Field.
Formulas
A formula reads the field as text. [Headquarters] gives the full address on one line. A part can be read on its own with a dot: [Headquarters].[location_city] gives the city. See Formula Functions & Operators.
Tip: Read each part with a dot rather than splitting the one-line address. An address with a second line or a suite has more parts than one without, so a split by position can return the wrong part.
Automations
The Address field is a compound field. In a trigger condition or an action mapping, pick one component, such as the country, instead of the whole address. An automation can then notify the privacy lead when a vendor's Headquarters country is outside the United States.
Forms
An Address field can be placed on a form, and the form offers the same Google suggestions as a record. See Form View.
Editing an Address field
Fix an address that is not on the map. Open the record, retype the address and pick it from the suggestions. The address then has a map position.
Change how it is shown. Open Modify Field Settings, switch Display Format between Single Line and Multiple Line, or turn Include Map Display off, then Update Field. The addresses do not change.
Change the field type. An Address field can become a Text, Text Area or SmartDoc field. See Changing a Field's Type.
Note: The field can change type to Text, Text Area or SmartDoc only. The address becomes plain text and leaves Map View.
Delete the field. Open the column menu and select Delete Field. Deleted fields sit in the Recycle Bin for 30 days.
Frequently asked questions
Why does a vendor not appear in Map View?
Why does a vendor not appear in Map View?
The address was typed without picking a Google suggestion, so it has no map position. Retype it and select it from the list.
Why is my new Address field empty?
Why is my new Address field empty?
A new field has no data until it is filled. It does not fill itself from other fields.
Can I group by city or state only?
Can I group by city or state only?
Yes. Group the view by the field and choose the component.
Does Include Map Display affect Map View?
Does Include Map Display affect Map View?
No. It controls the map preview under the field in a record only.
How do I get the city on its own in a formula?
How do I get the city on its own in a formula?
Read the part with a dot, for example [Headquarters].[location_city] for the city. Do not split the one-line address by position: an address with a second line or a suite has more parts, so the split can return the wrong part.
Can I change an Address field to another type?
Can I change an Address field to another type?
Yes, to Text, Text Area or SmartDoc only.
Last verified 1 Nov 2026.




