---
schema_version: "1"
id: 297ab50341aed7d24fdd2b1bc9525342be13ac7c3c6cd38ed175c4923276bb70
title: Configure State and Country/Territory Picklists
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/admin_state_country_picklists_configure.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.admin_state_country_picklists_configure.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 1e84d0ab22d472a11d12f006cf5e05e77b057d996b07dc0004a73edbd3658231
description: Configuring state and country/territory picklists means choosing which states and countries you want to be available in your Salesforce org. It lets you make state and country/territory picklists available for purposes like importing data, working with external systems, and accessing picklist data from the Metadata API.
products:
  - Salesforce Platform
  - Cross Cloud
release: "264"
---
# Configure State and Country/Territory Picklists

Configuring state and country/territory picklists means choosing which states and countries you want to be available in your Salesforce org. It lets you make state and country/territory picklists available for purposes like importing data, working with external systems, and accessing picklist data from the Metadata API.

### 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: <strong>All</strong> Editions except Database.com</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="d141332e64">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d141332e64 ">To configure state and country/territory picklists:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d141332e64 ">Modify All Data</td>

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

Configuring picklists isn’t required for you to enable state and country/territory picklists for users, but it’s highly recommended. Configuring picklists helps ensure continuity and data integrity with existing state, country, and territory data and customizations.

When configuring states, countries, and territories, you start with countries and territories, and then drill down to their states or provinces. State and country/territory picklists include 235 countries and territories by default. They also include the states and provinces of the United States, Canada, Australia, Brazil, China, Japan, India, Ireland, Italy, and Mexico. State and country/territory picklists that contain more than 1,000 states or countries/territories can cause degraded performance. For the complete list of default countries, see [Standard Countries and Territories for Address Picklists](https://help.salesforce.com/s/articleView?id=xcloud.admin_state_country_picklists_standard_countries.htm&release=264.0.0&type=5 "Salesforce provides 235 countries and territories as standard for country/territory address picklists. Additionally, some countries and territories have state codes with special considerations.").

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/images/icon_note.png)

Note

- Integration values for state and country/territory picklists can also be configured through the Metadata API. For more information, read about the AddressSettings component in the _Metadata API Developer Guide_.
- State and country/territory picklists aren’t supported in Salesforce change sets or packages. However, you can move integration value changes for state and country/territory picklists between sandbox and production orgs by using the Metadata API. To edit the existing states and countries in a picklist, configure your state and country/territory picklists in your sandbox org. Then, use the Metadata API to retrieve the sandbox configurations, and deploy them to your production org. You can’t deploy new ISO codes or update ISO code values using any API.

1. From Setup, enter State and Country/Territory Picklists in the Quick Find box, then select **State and Country/Territory Picklists**.
2. On the State and Country/Territory Picklists page, click **Configure States, Countries, and Territories**.
3. On the Configure States, Countries, and Territories page, select from the following options:
    - **Active**: Makes the country or territory available in the Metadata API so that records that contain the country or territory can be imported. However, unless you also set it as visible, the country or territory isn’t available to users in Salesforce. Otherwise, users can still make updates to an invisible country or territory through the API.
    - **Visible**: Makes the country or territory available to users in Salesforce. A country or territory must be active before you can make it visible.
4. Click **Edit** to view and edit details for the country, including to configure its states or provinces.
5. (Optional) Under Picklist Settings, select a Default Country/Territory. The Default Country/Territory automatically populates country/territory picklists for new records in your org, but users can select a different country or territory. Default countries and territories must be both active and visible.
6. To save your configuration, click **Save**.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/images/icon_note.png)

Note

- Active states and countries not marked Visible are still valid filter lookup values. You can use invisible states and countries when creating filters in reports, list views, workflows, and so on.
- If Custom Address Fields is enabled in your org, the Active checkbox for all countries and states is greyed out and cannot be changed. This limitation persists regardless of whether State and Country/Territory Picklists is enabled for standard fields. To manage which values are available to users when Custom Address Fields is active, use the Visible checkbox instead.

#### See Also

- [Edit State, Country, and Territory Details](https://help.salesforce.com/s/articleView?id=xcloud.admin_state_country_picklists_edit_details.htm&release=264.0.0&type=5 "To customize the states, countries, and territories in your picklists, edit their details.")
- [Let Users Select States, Countries, and Territories from Picklists](https://help.salesforce.com/s/articleView?id=xcloud.admin_state_country_picklists_overview.htm&release=264.0.0&type=5 "State and country/territory picklists let users select states, countries and territories from predefined, standardized lists, instead of entering state and country/territory data into text fields. State and country/territory picklists offer faster and easier data entry. They help to ensure cleaner data that can be harnessed for other uses—in reports and dashboards, for example. They protect data integrity by preventing typos, alternate spellings, and junk data—even in records updated through the API.")
- [Integration Values for State and Country/Territory Picklists](https://help.salesforce.com/s/articleView?id=xcloud.admin_state_country_picklists_integ_values.htm&release=264.0.0&type=5 "An integration value is a customizable text value that’s linked to a state or country/territory code. Integration values for states, countries, and territories default to the full ISO-standard state, country, and territory names. The way integration values function is similar to the way API names of custom fields and objects function. Configure integration values so integrations that you set up before enabling state and country/territory picklists continue to work.")