How to set up state country picklists on Salesforce

intermediate 8 min read Updated 2026-03-18

Quick Answer

State and Country Picklists in Salesforce standardize address data by providing predefined dropdown lists for countries and states/provinces. This feature replaces free-text address fields with controlled picklists to improve data quality and enable better reporting.

Try Salesforce Full Salesforce Review

Prerequisites

System Administrator or equivalent permissions in Salesforce
Understanding of Salesforce data validation rules
Familiarity with Salesforce setup menu navigation
Knowledge of your organization's address formatting requirements

Step-by-Step Instructions

Navigate to State and Country Picklists Setup

Click the Setup gear icon in the top right corner. In the Quick Find box, type State and Country and select State and Country Picklists from the results. You'll see the main configuration page with current settings displayed.

If you don't see this option, ensure you have System Administrator permissions and that your org supports this feature.

Enable State and Country Picklists

Click the Enable button on the State and Country Picklists page. Read the important information about data conversion, then check the box that says I understand that enabling this feature will convert existing country and state data. Click Enable to confirm. The conversion process will begin automatically.

This process is irreversible, so ensure you have a recent backup of your data before proceeding.

Configure Country Settings

After enabling, click Countries to manage the country list. Review the default countries and their Integration Values (typically ISO codes). To add a country, click New Country, enter the Country Name and Integration Value. To deactivate unwanted countries, uncheck the Active checkbox next to each country.

Use standard ISO country codes for integration values to ensure compatibility with external systems.

Set Up States and Provinces

Click States to manage state/province lists for each country. Select a country from the dropdown to view its states. Click New State to add states, entering the State Name, Integration Value (state code), and ensuring the correct Country is selected. Repeat for all required countries and their subdivisions.

Consider using standard abbreviations (like 'CA' for California) as integration values for consistency.

Update Address Fields on Objects

Navigate to Object Manager and select objects with address fields (Account, Contact, Lead, etc.). Go to Fields & Relationships and locate address fields like BillingCountry or MailingCountry. Click Edit on each field and ensure Restrict picklist to the values defined in the list is checked to enforce data quality.

Update all address-related fields consistently across all objects to maintain data integrity.

Configure Data Validation and Dependencies

Set up dependent picklists so states show only for their corresponding countries. In the state field settings, click Field Dependencies and create dependencies between country and state fields. Use the dependency matrix to specify which states appear for each country.

Test the dependencies in different browsers to ensure they work correctly for all users.

Test and Deploy Changes

Create test records in a sandbox or developer org first. Navigate to account, contact, or lead records and verify that country picklists display correctly and state fields update based on country selection. Check that existing data has been converted properly and that validation rules work as expected.

Involve end users in testing to identify any usability issues before full deployment.

Train Users and Update Documentation

Update user training materials to reflect the new picklist functionality. Create documentation showing the new address entry process and any changes to data entry workflows. Communicate the changes to all users who work with address data, including sales, marketing, and support teams.

Consider creating quick reference guides showing the most commonly used countries and states for your organization.

Common Issues & Troubleshooting

Existing address data appears corrupted after enabling picklists

Check the Data Integration Rules in State and Country Picklists setup. Review and update the mapping between old text values and new picklist values. You may need to run data cleansing reports to identify and fix unmapped values.

Users can't see certain countries or states in the picklists

Verify that the countries and states are marked as Active in the State and Country Picklists setup. Check field-level security settings to ensure users have read access to the address fields.

State field doesn't update when country is changed

Review the Field Dependencies configuration between country and state fields. Ensure the dependency matrix is properly configured and that both fields are visible on the page layout. Clear browser cache and test again.

API integrations fail after enabling picklists

Update API calls to use the Integration Values instead of display names. Check that external systems are sending valid country/state codes that match your Salesforce picklist values. Review API error logs for specific validation failures.

Prices mentioned in this guide are pulled from current plan data and may change. Always verify on the official Salesforce website before purchasing.

Visit Salesforce View Salesforce Pricing