×

Hupspot Salesforce Picklist Sync Guide

Sync Salesforce Picklists with Hubspot

Keeping Salesforce and Hubspot aligned is critical when you rely on accurate address data. This guide explains how to sync Salesforce state and country picklists with the default Hubspot Country/Region and State/Region properties so your teams can trust location data across both systems.

Why sync Salesforce and Hubspot picklists?

Sales and marketing workflows often depend on reliable country and state values. When Salesforce and Hubspot use different formats or options, you can end up with:

  • Duplicate or inconsistent values across the two CRMs
  • Failed workflows, lists, and reports based on location
  • Integration errors when syncing leads and contacts

By matching Salesforce state and country picklists with Hubspot properties, you standardize how location data is stored and updated.

Prerequisites before you configure Hubspot sync

Before you adjust anything, confirm that your Salesforce environment meets the following conditions:

  • Salesforce State and Country/Territory picklists are enabled and configured
  • The picklist values for countries and states are finalized in Salesforce
  • You have admin or equivalent permissions in both Salesforce and Hubspot
  • The Salesforce–Hubspot integration is installed and connected

These prerequisites ensure that your changes apply cleanly and that Hubspot can read the right data from Salesforce.

Understand how Hubspot and Salesforce store locations

Salesforce and Hubspot store address information in slightly different ways, which is important when you design your sync.

Standard address fields in Salesforce

Salesforce typically uses standard address fields such as:

  • Billing Country, Billing State
  • Shipping Country, Shipping State
  • Mailing Country, Mailing State (for contacts and leads)

When State and Country/Territory picklists are enabled, each of these fields references controlled picklist values instead of free text.

Default address properties in Hubspot

Hubspot includes a set of default CRM properties related to addresses, including:

  • Country/Region
  • State/Region
  • Street address, City, Zip code, and other details

For the sync to work correctly, the Country/Region and State/Region values in Hubspot must correspond to the picklist values defined in Salesforce.

Step 1: Review Salesforce state and country picklists

First, document which values Salesforce uses for countries and states.

  1. In Salesforce, go to Setup.
  2. Search for State and Country/Territory Picklists.
  3. Open the configuration and review the lists of countries and states or territories.
  4. Note the exact values, including spelling, punctuation, and abbreviations.

The goal is to understand the canonical list that Hubspot will need to align with.

Step 2: Align Hubspot Country/Region property

Next, compare the default Country/Region options in Hubspot with the list you documented from Salesforce.

  1. In Hubspot, navigate to Settings > Properties.
  2. Search for the Country/Region property.
  3. Open the property and review the available options (or allowed values).
  4. Compare each Hubspot country value with its Salesforce counterpart.

Make adjustments as needed so that each Salesforce country has a matching value in Hubspot. When possible, use identical labels and formats to minimize mapping and sync issues.

Tips for configuring the Hubspot Country/Region field

  • Avoid duplicate variations such as “United States” and “USA” at the same time.
  • Choose one standardized format (e.g., full country name) and use it both in Salesforce and Hubspot.
  • Ensure that your primary markets are present and spelled exactly the same in both systems.

Step 3: Align Hubspot State/Region property

After countries are aligned, repeat a similar process for the state or region values.

  1. In Hubspot, search for the State/Region property in the property settings.
  2. Open the property configuration to see existing options.
  3. From Salesforce, review each state or territory list attached to your active countries.
  4. Match each Salesforce state or territory value with the equivalent label in Hubspot.

Because states are often abbreviated in Salesforce, choose a consistent approach. For example, if Salesforce uses “CA” for California, configure Hubspot to use “CA” as well.

Considerations when syncing Hubspot state values

  • Keep one convention for all U.S. states (either two-letter codes or full names).
  • Apply consistent formats for Canadian provinces and other regions.
  • Update only active values that your teams truly need to reduce clutter in Hubspot.

Step 4: Set up field mappings between Salesforce and Hubspot

With values aligned, configure or review the field mappings in the Salesforce–Hubspot integration.

  1. Open your Salesforce integration settings in Hubspot.
  2. Go to Field mappings for contacts, companies, and other relevant objects.
  3. Locate the mappings that involve Country/Region and State/Region.
  4. Confirm that the correct Salesforce fields (for example, Mailing Country and Mailing State) map to the Hubspot Country/Region and State/Region properties.

Use a bidirectional sync where appropriate so that updates in either system remain consistent.

Recommended Hubspot mapping patterns

  • Sync primary mailing address fields from Salesforce to Hubspot contact properties.
  • Ensure company-level address fields map to Hubspot company properties, not contacts.
  • Test mappings for a small batch of records before applying changes broadly.

Step 5: Test and validate the Hubspot and Salesforce sync

Once mappings are set, thoroughly test the integration.

  1. Create or update a test record in Salesforce with specific country and state values.
  2. Confirm that the record syncs into Hubspot.
  3. Check the resulting Country/Region and State/Region values in Hubspot.
  4. Update the same record in Hubspot and confirm that the changes appear correctly in Salesforce.

Repeat the test with a few different countries and states to confirm coverage for your main regions.

Troubleshooting common Hubspot sync issues

If values do not sync as expected, consider the following checks:

  • Verify that the text values are an exact match between Salesforce and Hubspot.
  • Confirm that the integration user has permission to edit the relevant fields.
  • Look for inactive or deprecated picklist values in Salesforce that may still exist in Hubspot.
  • Review integration logs for any sync errors tied to address fields.

You can iterate on your picklist configuration and rerun tests until the sync behaves correctly.

Best practices for maintaining Hubspot and Salesforce alignment

After initial setup, create a simple governance process to keep both systems aligned over time.

  • Designate an owner for address standards across Salesforce and Hubspot.
  • Document your naming conventions for all countries and states.
  • Review new market expansions to ensure values are added in both systems at once.
  • Audit a sample of records quarterly to confirm that the sync is still accurate.

This proactive maintenance prevents data drift as your organization scales.

Helpful resources on Hubspot and Salesforce configuration

For deeper technical reference, you can review the original Salesforce picklist sync documentation on the Hubspot knowledge base. If you need expert guidance on broader CRM integration strategy, data quality, or marketing automation, you can also consult specialists at Consultevo.

By carefully aligning your Salesforce picklists with Hubspot address properties, you create a foundation of clean, consistent data that supports reporting, automation, and reliable customer communication across every touchpoint.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`

Verified by MonsterInsights