---
schema_version: "1"
id: 645707e6cd679b9ed5a55f912eb8146380caeda6342725765dd68df8f8b718f7
title: Address Screen Input Component
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/flow_ref_elements_screencmp_address.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.flow_ref_elements_screencmp_address.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 255f1d675923366fdc6c0743f1ff803f6bc635862d7b3b535f75bbeadea11e62
description: Simplify gathering address information by adding the Address component to a flow screen. The Address screen component shows a complete address form that’s customized to your settings. It can also use state and country/territory picklists.
products:
  - Flow Builder
  - Salesforce Platform
release: "264"
---
# Address Screen Input Component

Simplify gathering address information by adding the Address component to a flow screen. The Address screen component shows a complete address form that’s customized to your settings. It can also use state and country/territory picklists.

### 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;"><a href="https://help.salesforce.com/s/articleView?id=platform.flow_ref_supported_editions.htm&amp;release=264.0.0&amp;type=5" title="Learn about the editions and user interfaces that support Flow Builder. Some Flow Builder features integrate with other Salesforce products that require additional licenses.">View supported editions.</a></td></tr></tbody></table>

![An Address component with completed address fields.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/platform_automation/images/flow/flow_screencmp_address.png)

For information about adding screen components to your flow screen, see [Screen Element](https://help.salesforce.com/s/articleView?id=platform.flow_ref_elements_screen.htm&release=264.0.0&type=5 "Collect information from or display information to a user who runs the flow.").

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_note.png)

Note This screen component requires Lightning runtime.

## Configure the Address Component

You can select resources from the flow, such as variables or global constants, or you can manually enter a value.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:24%">
          <col style="width:76%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d90347e93">Attribute</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d90347e96">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">API Name</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>The API name of the component.</p>
              <p style="margin-bottom:0;">An API name can include underscores and alphanumeric characters without spaces.
                It must begin with a letter and can’t end with an underscore. It also can’t have
                two consecutive underscores.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">City Value</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>The city in the address.</p>
              <p>To give City a default value, set this
                attribute's value.</p>
              <p style="margin-bottom:0;">This attribute accepts single-value text resources.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">Country Code</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>The code for the country in the address. To give a country a default value, set
                this attribute's value.</p>
              <p style="margin-bottom:0;">This attribute accepts single-value resources, treated as
                text.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">Country Options</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>The active countries and territories configured in state and country/territory
                picklists. To override the options, set this attribute to a comma-delimited set of
                countries and territories. This field populates a dropdown menu of options.</p>
              <p style="margin-bottom:0;">This
                attribute accepts single-value text resources.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">Country Value</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>The value for the country in the address. To give a country a default value,
                set this attribute's value.</p>
              <p style="margin-bottom:0;">This attribute accepts single-value text
                resources.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">Disabled</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>If set to true, the user can’t
                modify the value. The default value is false.</p>
              <p style="margin-bottom:0;">This attribute accepts a resource
                with a Boolean value.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">Label</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>The label for the heading that appears preceding the group of address
                fields.</p>
              <p style="margin-bottom:0;">This attribute accepts single-value text resources.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">Postal Code Value</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p> The postal code for the address. For example, the ZIP code.</p>
              <p>To give the
                postal code a default value, set this attribute's value.</p>
              <p style="margin-bottom:0;">This attribute accepts
                single-value text resources.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">Required</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>If set to true, the running user
                must enter a value. The default value is false.</p>
              <p style="margin-bottom:0;">This attribute accepts a resource
                with a Boolean value.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">Show Google Maps Search Field</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>Indicates whether to include a search field powered by Google Maps in the
                component. To include a search field, enter <code>true</code> as a boolean value. When a user selects an address in the search
                field, the flow populates the other fields in the component.</p>
              <p style="margin-bottom:0;">The default value is
                <code>false</code>.
              </p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">Google Maps Search Field Label</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">The label that appears preceding the Google Maps search field.</td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">State or Province Code</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>The code for the state or province in the address. If you configure
                <strong class="uicontrol">State/Province Options</strong>, this value is selected by default.
                To give the state a default value, set this attribute's value.
              </p>
              <p style="margin-bottom:0;">This attribute
                accepts single-value text resources.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">State or Province Options</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>The active states that are configured in state and country/territory picklists.
                To override the options, set this attribute to a comma-delimited set of states. This
                field populates a dropdown menu of options.</p>
              <p style="margin-bottom:0;">This attribute accepts single-value
                text resources.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">State or Province Value</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>The value of the state or province in the address. If you configure
                <strong class="uicontrol">State/Province Options</strong>, this value is selected by default.
                To give the state a default value, set this attribute's value.
              </p>
              <p style="margin-bottom:0;">This attribute
                accepts single-value text resources.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e93 ">
              <strong class="uicontrol">Street Value</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e96 ">
              <p>The street number and street name for the address.</p>
              <p>To give Street a
                default value, set this attribute's value.</p>
              <p style="margin-bottom:0;">This attribute accepts single-value
                text resources.</p>
            </td>

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

## Set the Component Visibility

Specify the logic that determines when the flow displays the component.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:24%">
          <col style="width:76%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d90347e359">Option</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d90347e362">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Option" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e359 ">
              <strong class="uicontrol">When to Display Component</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e362 ">
              <p>Configure when the component is displayed by using conditional logic. </p>
              <p>You can set the components to:</p>
              <dl>

                <dt style="font-weight:bold;padding-top:.25rem;">Always</dt>

                <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Always display the component.</dd>


                <dt style="font-weight:bold;padding-top:.25rem;">When all conditions are met (AND)</dt>

                <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Display the component when all of the conditions that you define are met.
                  Define at least one condition.</dd>


                <dt style="font-weight:bold;padding-top:.25rem;">When any condition is met (OR)</dt>

                <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Display the component when at least one of the conditions that you define is
                  met. Define at least one condition.</dd>


                <dt style="font-weight:bold;padding-top:.25rem;">When custom conditional logic is met</dt>

                <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Display the component when the condition logic that you define is met.
                  Define at least one condition and specify condition logic.</dd>

              </dl>
            </td>

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

## Validate Input

Provide a formula that evaluates whether what the user entered is valid and the error message to display if invalid.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:24%">
          <col style="width:76%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d90347e450">Option</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d90347e453">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Option" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e450 ">
              <strong class="uicontrol">Error Message</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e453 ">Specify the error message that appears below the component if the user enters
              an invalid value.</td>

          </tr>
          <tr class="">
            <td data-label="Option" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e450 ">
              <strong class="uicontrol">Formula</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e453 ">
              <p>Provide a formula expression that returns a Boolean value.</p>
              <p>If the formula expression evaluates to <samp>true</samp>, the
                input is valid. If the formula expression evaluates to
                <samp>false</samp>, the error message appears below the
                component.
              </p>
              <p style="margin-bottom:0;">If the user leaves the field blank and the field isn’t required, the flow doesn’t
                perform the validation. If the user leaves the field blank and the field is
                required, the flow shows the default error message and not your custom error
                message.</p>
            </td>

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

## Store the Address Component’s Values in the Flow

The flow stores values automatically. If you store values manually, store the attribute’s output value in a variable.

To store values manually, select **Manually assign variables (advanced)**.

All attributes are available to store in flow variables. Most likely, you must store one of these attributes.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:24%">
          <col style="width:76%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d90347e541">Attribute</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d90347e544">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e541 ">
              <strong class="uicontrol">City Value</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e544 ">
              <p>What the user entered in the City Value field.</p>
              <p style="margin-bottom:0;">Store this value in a
                single-value text variable or a text field on a record variable.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e541 ">
              <strong class="uicontrol">Country Code</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e544 ">
              <p>What the user entered in the Country Code field.</p>
              <p style="margin-bottom:0;">Store this value in a
                single-value text variable or a text field on a record variable.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e541 ">
              <strong class="uicontrol">Country Value</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e544 ">
              <p>What the user entered in the Country Value field.</p>
              <p style="margin-bottom:0;">Store this value in a
                single-value text variable or a text field on a record variable.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e541 ">
              <strong class="uicontrol">Postal Code Value</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e544 ">
              <p>What the user entered in the Postal Code field.</p>
              <p style="margin-bottom:0;">Store this value in a
                single-value text variable or a text field on a record variable.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e541 ">
              <strong class="uicontrol">State or Province Code</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e544 ">
              <p>What the user entered in the State or Province Code field.</p>
              <p style="margin-bottom:0;">Store this value
                in a single-value text variable or a text field on a record variable.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e541 ">
              <strong class="uicontrol">State or Province Value</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e544 ">
              <p>What the user entered in the State of Province Value field. To update records
                in orgs with the State and Country/Territory Picklists setting enabled, use State or
                Province Code instead.</p>
              <p style="margin-bottom:0;">Store this value in a single-value text variable or a text
                field on a record variable.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e541 ">
              <strong class="uicontrol">Street Value</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e544 ">
              <p>What the user entered in the Street Value field.</p>
              <p style="margin-bottom:0;">Store this value in a
                single-value text variable or a text field on a record variable.</p>
            </td>

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

![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_tip.png)

Tip By default, screen components that run on Lightning runtime version 58 and prior have no memory. If a user enters a value, and then does one of the following, the value is lost.

- Navigates to another screen and returns to the component’s screen.
- Pauses the flow then resumes it.
- Navigates to the next screen and triggers an input validation error.

Setting the attribute enables a flow to remember the value. The flow stores the value automatically. If you store values manually, store the attribute’s output value in a variable.

## Specify the Behavior of Values on Revisited Screens

Specify what this component does when a user enters a value, navigates to a previous screen, and then returns to the screen with this component.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:24%">
          <col style="width:76%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d90347e697">Option</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d90347e700">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Option" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e697 ">
              <strong class="uicontrol">Use values from when the user last visited this screen</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e700 ">The component retains the values that the user specified and doesn’t update the
              values to reflect changes made on previous screens.</td>

          </tr>
          <tr class="">
            <td data-label="Option" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e697 ">
              <strong class="uicontrol">Refresh inputs to incorporate changes elsewhere in the flow</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d90347e700 ">
              <p>The component updates the user-specified values to reflect changes made on
                previous screens.</p>
              <p style="margin-bottom:0;" id="flow_ref_elements_screencmp_address__d3145e119"><a name="flow_ref_elements_screencmp_address__d3145e119"><!-- --></a>If you pause and then
                resume the flow, the flow retains user-specified values only in Checkbox, Checkbox
                Group, Currency, Long Text Area, Multi-Select Picklist, Number, Password,
                Picklist, Radio Buttons, and Text components.</p>
            </td>

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

## Considerations

- To update records in orgs with the State and Country/Territory Picklists setting enabled, use the Country Code and State or Province Code outputs instead of the Country Value and State or Province Value outputs.
- The Country and State/Province fields show as picklists instead of text fields when either:
    - The screen flow is embedded in a Lightning Experience site
    - The screen flow is embedded in an Aura Experience site and the State and Country/Territory Picklists setting is enabled
- The Google Maps search field isn’t supported in Playground, Experience Builder sites, Lightning Out, Lightning Components for Visualforce, and standalone apps.

#### See Also

- [Standard Flow Screen Components](https://help.salesforce.com/s/articleView?id=platform.flow_ref_elements_screencmp.htm&release=264.0.0&type=5 "Salesforce provides several standard screen components that extend the types of input fields available in screens.")