---
schema_version: "1"
id: 609b5f4c2c465342c75e07e48fa7bf2606b78e3049e65a1ca810a0b0387f377c
title: State and Country/Territory Picklists and Metadata API
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_api.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.admin_state_country_picklists_api.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 04d911d2913af87645b94c9656d7639b5a364d6a051ac85b2aba7b50440b2ca1
description: If you’re editing many state and country/territory picklist integration values, usingMetadata API is more efficient than editing values in Setup.
products:
  - Salesforce Platform
  - Cross Cloud
release: "264"
---
# State and Country/Territory Picklists and Metadata API

If you’re editing many state and country/territory picklist integration values, usingMetadata API is more efficient than editing values in Setup.

### 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>

You can use Metadata API to edit existing states, countries, and territories in state and country/territory picklists. You can’t use Metadata API to create or delete new states, countries, or territories.

To edit the existing states and countries in a picklist, configure your state and country/territory picklists in your sandbox org. Then, use 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.

Search for "AddressSettings" in the [_Metadata API Developer Guide_](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/) for information about working with state and country/territory picklists in Metadata API.

![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 AddressSettings data can change periodically, which causes discrepancies in state or country labels when deploying AddressSettings data retrieved from another org. To resolve this issue, edit the retrieved metadata to match the destination org before deployment.

#### See Also

- [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.")
- [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.")