Loading tutorials…
Loading tutorials…
Properties are the foundation under every workflow, segment, and report in HubSpot. Most owners create 80+ custom properties in the first month, then spend the next year cleaning up the mess. Here's the discipline to do it right the first time.
Who this is forOwners or ops leads about to start customizing HubSpot — or anyone who inherited a portal with 200+ unsorted properties and needs to figure out what to keep, archive, or merge. If you're paying $890/mo for Marketing Hub Pro but using 15% of features, property bloat is usually the symptom.
What you'll need
Step 1
Before creating a single new property, audit what HubSpot already gives you. Default properties cover 70% of common needs.
Click Settings (gear icon, top-right) → Properties → Contact properties.
Filter by Group → 'Contact information' and 'Conversion information.' Read through every default property. HubSpot ships ~150 contact properties out of the box.
Common defaults that owners re-create unnecessarily: Lifecycle Stage, Lead Status, Original Source, Recent Conversion, Number of Sessions, Time First Seen, Country, City, Job Title.
For each "I need a field for X" idea, search the default list first. If it exists, use it. Custom properties should be the exception, not the rule.
Step 2
Group your properties by team or workflow purpose. This is what keeps the property panel readable at scale.
In Settings → Properties → Contact properties → click "Property groups" tab.
Create groups that match how your team thinks. Common ones: "Sales qualification," "Marketing attribution," "Product usage," "Billing/Stripe," "Customer success."
Keep groups to 8-15 properties each. Beyond 15, split into sub-groups.
Never use the "Other" or default catch-all group as a permanent home for custom fields — properties there get forgotten and re-created later.
Step 3
Field type is permanent. Change it later and you lose data. Picking the wrong type is the most expensive property mistake.
Click Create property. Choose the object: Contact (or Company / Deal for those records).
Property group: pick from the groups you just created.
Field type — choose carefully: Single-line text (free-form, hard to segment), Dropdown select (best for fixed options like Industry), Multi-checkbox (only when an option can have multiple values, like multi-product purchases), Number (for currency, counts, MRR), Date picker (for events with a date), Calculation (derived from other properties).
For dropdowns, lock the option list early. Adding new options later is fine; renaming or merging is messy and breaks historical reports.
For revenue/MRR fields, use Number not Currency — Currency field rendering is locked to portal currency and creates problems in multi-currency portals.
Description field: write it for the next person, not for yourself. Future-you will not remember why this property exists.
Step 4
If you sync from Salesforce, Stripe, or any system, the field mapping is permanent. Get it right before turning on the integration.
List every field in your source system you actually need in HubSpot. For most stacks: 8-20 fields max from Salesforce, 3-5 from Stripe, 4-8 from a product DB.
For each source field, decide: does an existing HubSpot property cover it (map to that) or does it need a new custom property (create one first)?
In the integration setup (Settings → Integrations → your tool → Field mappings), wire each source field to its HubSpot property. Set sync direction: one-way to HubSpot for source-of-truth fields (e.g., Stripe MRR), two-way only when both systems can legitimately update the value.
Never map two source systems to the same HubSpot property. Salesforce + Pipedrive both writing to 'Company' field will overwrite each other every sync cycle.
Step 5
Calculation properties (Marketing Hub Pro+) derive a value from other properties. Use them for "days since last activity" or "lead score per industry."
In Properties → Create property → choose "Calculation" field type (requires Pro or Enterprise).
Examples that earn their keep: "Days since last form submission" = TODAY() - Last Form Submission Date, "Customer tenure in months" = (TODAY() - Became a Customer Date) / 30, "Revenue per lead source" = MRR / (1 if first source = paid)
Calculations evaluate on read, not write. They always reflect current data. But they can't be used in workflow enrollment criteria — only in lists and segments.
Limit yourself to 5-10 calculation properties initially. They are computationally cheap, but mentally expensive to maintain.
Step 6
Archived properties stay in HubSpot but disappear from forms, segments, and contact records. This is how you keep the portal usable.
Open Settings → Properties → Contact properties. Filter by "Used in" → "Not used in any workflow/list/form/email."
For any property in this list that has no recent values, archive it. Click the three-dot menu → Archive.
Run this audit quarterly. Property bloat compounds — 10 custom properties become 50 in a year if nobody prunes.
You cannot archive default HubSpot properties (they reactivate themselves). For defaults you genuinely never use, just hide them from forms and contact-record layouts.
Common mistakes
Re-creating default properties as custom ones
What goes wrong: You have 'Industry,' 'industry__c,' and 'company_industry' all populated with conflicting data. Workflows can't reliably segment by industry. Reports show three different industry counts.
How to avoid: Audit existing properties before creating new ones. If a default exists, use it. If you must rename for clarity, edit the default property's label rather than creating a duplicate.
Using Multi-checkbox where Dropdown belongs
What goes wrong: You picked Multi-checkbox for 'Industry' because it felt safer. Now contacts can have 4 industries, segmentation breaks ('Industry contains SaaS' returns the wrong set), and reports double-count.
How to avoid: Use Multi-checkbox only when one contact legitimately has multiple values (products purchased, channels used). For everything else, use Dropdown.
Mapping two source systems to the same property
What goes wrong: Salesforce and Pipedrive both write to 'Company.' Every sync cycle, one overwrites the other. Field values flip every 15 minutes. Workflows that depend on Company become unstable.
How to avoid: One source system per HubSpot property for any field with sync enabled. If you need multiple sources, create separate properties ("Company (Salesforce)" and "Company (Pipedrive)") and reconcile with a calculation property.
Not writing descriptions on custom properties
What goes wrong: Six months later, nobody remembers what 'lead_quality_v2' means. It's used in 4 workflows and 2 reports nobody dares delete. The portal slowly accretes mystery fields.
How to avoid: Make property descriptions mandatory in your team standards. Include: what it represents, who/what populates it, and when it was created.
Creating 80+ custom properties in month 1
What goes wrong: Property panel becomes unusable. Forms show 40 options when 5 would do. Sales reps stop trusting the data because they can't tell which fields are current.
How to avoid: Start with 10-15 custom properties max. Add more only when a specific workflow or report demands one. Run a quarterly cleanup audit.
Changing field type after data exists
What goes wrong: You created 'MRR' as Single-line text in month 1. Now you want to use it in calculations. Changing type loses all existing data. You re-import 8 months of MRR from Stripe.
How to avoid: Get field type right at creation. If in doubt, ask: will I ever want to do math on this, segment by ranges, or sort by it? If yes, Number. If no, Text.
Recap
Done — what's next
How to set up HubSpot lifecycle stages so marketing and sales actually agree
Read the next tutorial
Hand it off
Property hygiene is the kind of work that pays off in year two, not week one. A specialist who has set up 50+ portals knows which fields to skip, which to lock, and which to sync — and saves you the year of cleanup that DIY portals usually need. EverestX HubSpot specialists run $400-1,200/mo at $14-16/hr depending on portal complexity.
See specialist rates
A healthy mid-size HubSpot portal has 20-40 custom contact properties on top of HubSpot defaults. Anything over 80 usually signals bloat. Anything over 150 is a sign nobody has owned property hygiene for a while.
Match the property to the object it describes. "Industry" lives on Company (companies have industries, contacts work at companies). "Decision-maker title" lives on Contact. "Expected close date" lives on Deal. Properties on the wrong object cause reporting headaches forever.
Yes, via Settings → Import → upload your CSV and map columns. HubSpot auto-creates properties for unmapped columns. Be careful — auto-created properties default to Single-line text and get dumped in the 'Other' group. Pre-create them with the right types before importing.
A property is a field on an existing object (Contact, Company, Deal, Ticket). A custom object (Marketing Hub Enterprise / Operations Hub Pro+) is a new object type entirely — like 'Subscriptions,' 'Inventory units,' or 'Properties' for a real-estate firm. Use custom objects only when no existing object fits.
Use Operations Hub data sync or a one-off workflow: enrollment criteria = old property is known, action = copy value to new property + clear old property. For large data sets, export to CSV, transform, and re-import.
HubSpot Marketing Hub
Lifecycle Stage is the most misunderstood property in HubSpot. Set it up wrong and marketing reports show 'MQLs created' that sales never touches. Set it up right and the whole pipeline becomes legible. Here's the taxonomy and automation that holds up.
HubSpot Marketing Hub
Workflows are the engine under HubSpot's marketing automation. They are also where 80% of the silent breakage happens — wrong enrollment criteria, missing re-enrollment toggles, branch logic that loops. Here's how specialists build them so they hold up.
HubSpot Marketing Hub
Lead scoring is the most-built and least-used feature in HubSpot. Most setups generate scores that nobody references because they don't match how sales actually qualifies. Here's the model that earns sales trust — and the decay rules most owners skip.
HubSpot Marketing Hub
HubSpot is one of the most powerful platforms in marketing — and one of the easiest to over-configure into uselessness. Here's the honest framework: when DIY costs you more than hiring, and how to tell which side of the line you're on.