How to Standardize Addresses in HubSpot
Address data in HubSpot is deceptively messy. It looks fine on a glance — there's a street, a city, a state, a zip code. But try to use that data for anything beyond displaying it on a record, and the inconsistencies become a real problem.
The same physical address might appear in your HubSpot portal as:
- 123 Main Street, Suite 200
- 123 Main St., Ste. 200
- 123 Main St Ste 200
- 123 Main St., #200
- 123 Main Street Suite 200, Chicago, IL 60601
- 123 main st ste 200
Each of those is the same location, but HubSpot sees six different strings. Deduplication misses them. Mailing lists double-send. Territory assignments break. Regional reports miscount.
Here is what an address abbreviation standardization pass looks like in practice:
Why address standardization matters in HubSpot
Duplicate detection. HubSpot's deduplication tools compare property values as exact strings. Two company records at "100 Park Avenue" and "100 Park Ave" will never be flagged as potential duplicates based on address matching alone.
Direct mail and physical outreach. If your sales or marketing team sends physical mailers, gift boxes, or event invitations, inconsistent addresses mean wasted postage, returned packages, and missed opportunities. Most mailing services require USPS-standardized addresses for bulk rates.
Territory and routing rules. If you assign leads to reps based on geography, address inconsistencies can cause misrouting. A workflow that checks whether the street address contains "Ave" will miss records stored as "Avenue."
Reporting accuracy. Regional revenue reports, market analysis by area, and location-based segmentation all depend on consistent address data.
HubSpot's address properties
HubSpot stores addresses across several default properties for both contacts and companies:
- Street address (address, street)
- City (city)
- State/Region (state)
- Zip/Postal code (zip)
- Country (country)
The biggest inconsistencies live in the street address field, which is free text and accepts anything. City, state, and country have fewer variations but still drift (see our country normalization guide for that specific problem).
Common street address inconsistencies
Street type abbreviations
The USPS defines standard abbreviations for street types. In practice, people use a mix of full words, abbreviations with periods, and abbreviations without periods.
| Full | Common Variants | USPS Standard |
|---|---|---|
| Street | St., St, Str. | ST |
| Avenue | Ave., Ave, Av. | AVE |
| Boulevard | Blvd., Blvd, Boul. | BLVD |
| Drive | Dr., Dr | DR |
| Road | Rd., Rd | RD |
| Lane | Ln., Ln | LN |
| Court | Ct., Ct | CT |
| Circle | Cir., Cir | CIR |
| Place | Pl., Pl | PL |
| Way | Wy. | WAY |
| Parkway | Pkwy., Pkwy | PKWY |
| Terrace | Ter., Terr. | TER |
| Highway | Hwy., Hwy | HWY |
You have two reasonable choices: standardize to the full word (more readable) or to the USPS abbreviation (more compact, matches mailing standards). For a CRM, full words are generally easier to read. For mailing purposes, USPS abbreviations are preferred.
Unit and suite designators
These are the secondary address components — suite numbers, apartment numbers, floor numbers — and they're wildly inconsistent:
- Suite 200 / Ste. 200 / Ste 200 / #200 / STE 200
- Apartment 4B / Apt. 4B / Apt 4B / #4B / APT 4B
- Floor 3 / Fl. 3 / Fl 3 / 3rd Floor / 3F
- Unit 5 / Unit #5 / #5
Directional prefixes and suffixes
North, South, East, West — and their abbreviations N, S, E, W — appear before or after street names:
- 100 North Main Street / 100 N. Main Street / 100 N Main St
- 500 West Broadway / 500 W Broadway / 500 W. Broadway
Punctuation and spacing
Periods after abbreviations (St. vs St), commas between address components, double spaces, leading/trailing whitespace. These seem trivial but break string comparisons.
Standardization strategy
Address cleanup is best approached in layers, from the most impactful changes to the smallest details.
Layer 1: Street type normalization
Pick your standard (full word or abbreviation) and work through the common street types. Using search and replace with regex:
To expand abbreviations to full words:
| Search (regex) | Replace |
|---|---|
\bSt\.?\b (at end of address) | Street |
\bAve\.?\b | Avenue |
\bBlvd\.?\b | Boulevard |
\bDr\.?\b | Drive |
\bRd\.?\b | Road |
\bLn\.?\b | Lane |
\bCt\.?\b | Court |
\bPkwy\.?\b | Parkway |
\bHwy\.?\b | Highway |
\bCir\.?\b | Circle |
\bPl\.?\b | Place |
\bTer\.?\b | Terrace |
The \b word boundary is important here. Without it, \bSt\.?\b could match "St" inside "Store" or "Stone." And you need to be careful with "Dr" — it could be "Drive" or "Doctor" depending on context. Preview every replacement.
Important caveat about "St": The abbreviation "St" can mean "Street" or "Saint" (as in "St. Louis" or "St. Patrick's Lane"). Your regex needs to account for position — "St" at the end of an address line is almost always "Street," while "St" followed by a proper noun is "Saint." This is one of those cases where a preview-before-applying workflow saves you from bad replacements.
Layer 2: Suite and unit standardization
Decide on one format and normalize everything to it.
| Search | Replace |
|---|---|
\bSte\.?\s* | Suite |
\bApt\.?\s* | Apartment |
\bFl\.?\s* | Floor |
#(?=\d) | Suite (if your convention is to expand # to Suite) |
The # symbol is particularly tricky because some addresses use it for suite numbers and others use it for apartment numbers. If you can't distinguish programmatically, pick one and apply it consistently.
Layer 3: Directional standardization
Either expand or abbreviate directional prefixes.
| Search | Replace |
|---|---|
\bN\.?\s | North |
\bS\.?\s | South |
\bE\.?\s | East |
\bW\.?\s | West |
\bNW\.?\s | Northwest |
\bNE\.?\s | Northeast |
\bSW\.?\s | Southwest |
\bSE\.?\s | Southeast |
Again, context matters. \bN\.?\s followed by a number is likely "Number" not "North." Preview catches these.
Layer 4: Cleanup punctuation and whitespace
Remove trailing periods: Search for \.\s*$ and replace with nothing (strips periods at the end of the address).
Normalize double spaces: Search for \s{2,} and replace with a single space.
Trim whitespace: Search for ^\s+|\s+$ and replace with nothing.
Normalize comma usage: If you want a comma before the suite designator, or don't, now is the time to enforce it.
Executing in SearchReplace
Address standardization is a methodical process. For each layer:
- Select the street address property on the object type you're cleaning (contacts, companies, or both)
- Enter the search pattern for one abbreviation
- Enter the replacement
- Preview the results
The preview step matters more for addresses than for almost any other property. Street abbreviations overlap with common words, directional abbreviations can be ambiguous, and context determines meaning. Take a few seconds to scan the preview for false positives before applying.
A full address standardization pass — all street types, suite designators, directionals, and punctuation — typically involves 20-30 individual operations. It sounds like a lot, but each one takes about a minute with preview. You can complete a comprehensive cleanup in an afternoon.
Handling the city and state fields
City names usually have fewer issues, but you'll occasionally find abbreviations (NYC for New York, LA for Los Angeles, SF for San Francisco) or casing problems. Standardize to the full city name in Title Case.
State fields should use either full names (California) or two-letter USPS codes (CA), but not a mix. Search for full state names and replace with codes, or vice versa. This is a finite list — 50 states plus territories — and each replacement is straightforward.
USPS address validation
For businesses that send physical mail, true address standardization means USPS CASS certification — verifying the address against the postal database and formatting it exactly to USPS standards. This is beyond what a search-and-replace tool does. Services like SmartyStreets, Lob, and Melissa Data offer API-based address verification that can be integrated with HubSpot.
However, search-and-replace cleanup is an important first step even if you plan to run USPS validation later. Validation services work better when the input data is reasonably formatted — "123 Main St" validates better than "123 main st., " with a trailing comma and space.
Preventing future address mess
Use structured address forms. Separate fields for street, suite/unit, city, state, and zip. Don't let visitors enter everything in one text box.
Add property descriptions. On the street address property in HubSpot, add help text specifying your format: "Full street names (Street, not St.), Suite for secondary address (Suite 200, not #200)."
Validate on import. Before every CSV import, run the address column through a standardization pass. Even a simple find-and-replace in your spreadsheet catches the most common abbreviation variants.
Consider a lookup table. Maintain a simple spreadsheet mapping abbreviations to full words. Anyone preparing an import can use it as a reference.
Address data is one of those properties where "close enough" works for display but fails for operations. If you're doing territory assignments, mailing campaigns, or deduplication based on address, consistency is not optional — it's foundational. A structured cleanup gets you there, and consistent entry practices keep you there.
Keep working through the cleanup
Related HubSpot guides for planning, previewing, and validating the next step.
Annual HubSpot Data Review: The Complete Checklist
A comprehensive checklist for reviewing your HubSpot data at the end of the year. Covers contacts, companies, deals, properties, integrations, and compliance.
Read guideHow to Clean Up Company Names in HubSpot
Inc vs Inc., LLC vs L.L.C., extra spaces and inconsistent suffixes — here's how to standardize company names in your HubSpot CRM for cleaner data and better reporting.
Read guideHow to Fix HubSpot Import Errors After a Bad CSV Upload
A bad CSV import can corrupt thousands of HubSpot records in minutes. Here's how to identify the damage, fix it, and prevent it from happening again.
Read guideHow to Clean Up Job Titles in HubSpot
Job titles in your HubSpot CRM are probably a mess — VP, V.P., Vice President all mean the same thing. Here's how to standardize them for better segmentation and lead scoring.
Read guideStill editing HubSpot records one by one?
Start with 100 free applied records — no credit card required.