---
schema_version: "1"
id: cdf6d7afbb5110231dec96bd440da443692c97b7e503c4625880da00eef1121d
title: Create a Custom Address Field
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/fields_caf_create.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.fields_caf_create.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 8b106f83ddb7e648b95d609b1b3c8eb8c8bee324c7fb3035e0d549b922c198e1
description: Use the Address field type to create a custom address field that mimics the behavior of standard address fields. For example, add a Warehouse Address field to a standard or custom object. Users can populate a custom address field manually, or they can use the Google lookup to search for an address. Then you can access each address that’s stored in a custom address field, either as a structured compound data type or as individual address components.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Create a Custom Address Field

Use the Address field type to create a custom address field that mimics the behavior of standard address fields. For example, add a Warehouse Address field to a standard or custom object. Users can populate a custom address field manually, or they can use the Google lookup to search for an address. Then you can access each address that’s stored in a custom address field, either as a structured compound data type or as individual address components.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: both Salesforce Classic and Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: all editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d58413e60">User
              Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d58413e60 ">To create or change custom fields:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d58413e60 ">Customize Application</td>

          </tr>
        </tbody>
      </table>

Before you can create a custom address field, enable this feature in User Interface Settings. For more information, see [Enable Custom Address Fields](https://help.salesforce.com/s/articleView?id=platform.fields_caf_enable.htm&release=264.0.0&type=5 "After you review the feature limitations and configure the State and Country/Territory picklists, enable custom address fields. Then you can add custom fields to standard and custom objects in Object Manager using the compound Address field type.").

Before you create a custom address field, review the [requirements and limitations](https://help.salesforce.com/s/articleView?id=platform.fields_caf_requirements.htm&release=264.0.0&type=5 "Before you enable custom address fields, configure State and Country/Territory picklists and review these considerations.").

1. In your Salesforce org, click ![The gear icon.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/admin_setup_gear_icon.png) and select **Setup**.
2. Click the Object Manager tab. If you don’t see it, enter Object Manager in the Quick Find box and select **Object Manager**.
3. From the Object Manager page, select the object to which you want to add the custom address field.
4. From the sidebar, click **Fields & Relationships**.
5. To create a custom field, click **New**.
6. Choose **Address** as the data type. Address is at the bottom of the data type list.
    
    ![The Data Type selection screen.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/fields_caf_address_type.png)
7. Click **Next**.
8. Enter the field label and field name.
    
    The field label appears above the custom address field and at the beginning of each component label. When you specify your field label, consider whether the word Address is needed. In many cases, the field label doesn’t require the word Address. To help API users, you can add the word Address to the field name.
    
    Here’s the label field when building or editing a field in Object Manager.
    
    ![The field details screen in Object Manager.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/fields_caf_details.png)
    
    And here’s the field on the Account object.
    
    ![The field details screen in Object Manager.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/fields_caf_example.png)
9. Optionally, enter a description and help text, and select whether to add the new field to custom reports. Then click **Next**.
10. Select the field’s visibility and edit access.
11. Select the Dynamic Forms-enabled Lightning record pages that should include the field, then click **Next**.
    
    If you don’t have any Dynamic Forms-enabled Lightning record pages for the object, this step doesn’t appear.
12. Click **Next**. Then click **Save**.
13. To edit the placement of the custom address field on the pages associated with this object, click **Page Layouts**.

#### See Also

- [Custom Address Fields](https://help.salesforce.com/s/articleView?id=platform.fields_caf.htm&release=264.0.0&type=5 "Improve address data accuracy and the end-user experience with Custom Address Fields. Users can populate a custom address field manually or they can use the Google lookup to search for an address. Admins and APIs can access each address stored in a custom address field as a structured compound data type as well as individual address components.")
- [Considerations for Custom Address Fields](https://help.salesforce.com/s/articleView?id=platform.fields_caf_requirements.htm&release=264.0.0&type=5 "Before you enable custom address fields, configure State and Country/Territory picklists and review these considerations.")
- [Page Layouts](https://help.salesforce.com/s/articleView?id=platform.customize_layout.htm&release=264.0.0&type=5 "Page layouts control the layout and organization of buttons, fields, s-controls, Visualforce, custom links, and related lists on object record pages. They also help determine which fields are visible, read only, and required. Use page layouts to customize the content of record pages for your users.")