HubSpot custom properties are the difference between a CRM that runs your business and a CRM that just stores names and email addresses. HubSpot ships with 200+ default properties, but the fields that actually drive your sales process, your reporting, and your automation are the custom ones you build yourself.
This guide walks through exactly how to set up HubSpot custom properties the right way — what to create, what to avoid, and the naming conventions that prevent a five-person team from turning a clean CRM into an unusable mess by year two.
What a HubSpot Custom Property Actually Is
A custom property is a field you add to a HubSpot object — contact, company, deal, ticket, or custom object — that captures information HubSpot doesn’t track by default. Industry. MRR. Contract renewal date. Implementation phase. Anything specific to how your business runs.
Every property has three things that matter: its field type (single-line text, dropdown, number, date, checkbox, multi-select), its object (contact, company, deal, etc.), and its property group (the bucket it shows up in when you view a record).
Step 1: Build a Data Dictionary Before You Build Anything Else
The single biggest mistake I see with HubSpot custom properties: teams create them ad-hoc as they go. Six months later you have 40 fields with inconsistent names, nobody remembers what “Status 2” means, and reporting is broken.
Before you create a single property, write a data dictionary. For each field, document:
- Property name (what shows in the UI)
- Internal name (the API slug — snake_case, no spaces)
- Object (contact, company, deal, ticket)
- Type (dropdown, text, number, date)
- Options (if dropdown — write every option now, don’t add them later one at a time)
- Who owns it (which team can edit — sales, marketing, service)
- Source (how it gets populated — manual, form, workflow, integration)
A Google Sheet or Notion doc works fine. This dictionary becomes the source of truth for every property decision.
Step 2: Use Dropdowns, Not Open Text (Whenever Possible)
Open-text fields are where reporting goes to die. If you want to track lead source and you use a text field, you’ll end up with “LinkedIn,” “linkedin,” “LI,” “Linked In,” and “linkedin.com” — all different values, all uncountable in a report.
Default to dropdown select, multi-select, or checkbox field types for anything categorical: industry, lifecycle stage modifier, region, persona, product interest, lead source. Reserve open text for things that truly are unique per contact, like job title or a specific request note.
Step 3: Naming Conventions That Scale
Pick a naming convention on day one and enforce it. My default for client builds:
- Property name — Title Case with spaces. “Annual Revenue” not “annual_revenue” or “ANNUAL REVENUE”
- Internal name — lowercase, snake_case. “annual_revenue”
- Prefix for custom-sourced fields — if a field comes from a specific source like ZoomInfo or your product, prefix it: “zi_employee_count” or “prod_trial_started”
- Group prefix for custom groups — “Sales — Deal Close Data,” “Marketing — Campaign Attribution”
Consistency matters more than the specific convention. Pick one, write it in the data dictionary, and make every new property follow it.
Step 4: Assign a Property Owner
In every HubSpot portal I manage, exactly one person has the power to create custom properties. Everyone else submits a request. This single rule prevents 90% of data-quality problems that show up after year one.
Set up a simple request process in your HubSpot instance: a shared form that captures the new property’s name, object, type, options, owner, and business justification. The admin reviews, decides if it duplicates an existing field, and creates it following the naming convention.
Step 5: Custom Property Types You Should Probably Build
Starting point list — these 12 custom properties are in almost every B2B HubSpot portal I set up:
Contact-level
- Lead Source (dropdown) — paid search, organic, referral, outbound, event, partner, content download
- Persona (dropdown) — your ICP buyer personas with clear names
- MQL Date (date) — when they crossed the marketing-qualified threshold
- SQL Date (date) — when sales accepted the lead
Company-level
- Employee Count (number) — even if you enrich from a provider, keep a HubSpot-native field for reporting
- Annual Revenue (number) — same reason
- ICP Tier (dropdown) — Tier 1 / Tier 2 / Tier 3 / Out-of-ICP
- Tech Stack (multi-select) — which competing tools they use (critical for positioning)
Deal-level
- Primary Competitor (dropdown) — who you lost to or are competing against
- Next Step (single-line text) — what has to happen to advance
- Forecast Category (dropdown) — Commit / Best Case / Pipeline / Omitted
- Loss Reason (dropdown) — only fills on closed-lost, but feeds the most valuable report you’ll run
Step 6: Audit Custom Properties Every Quarter
Custom properties grow. Every 90 days, pull the full property list (Settings → Properties) and review:
- Is it still being used? Check the “Last updated” timestamps on a sample of records
- Is it still accurate? Dropdown options may be stale (old personas, deprecated products)
- Does it duplicate something else? Merge and deprecate
- Should it move to a different object? Contact-level data that really belongs on company
Set a quarterly recurring task in HubSpot with the data dictionary owner assigned. This is the single most under-rated HubSpot admin habit in the industry.
Frequently Asked Questions
How many custom properties can you create in HubSpot?
The limit depends on your HubSpot subscription. Free tools have a low cap, Starter and Professional allow far more, and Enterprise tiers permit hundreds to thousands of custom properties per object. Check Settings → Properties → “Data quality” to see your current count versus your tier’s limit. If you downgrade tiers, existing properties remain visible and editable but you can’t create new ones beyond the lower limit.
What’s the difference between contact and company properties?
Contact properties describe a person — their role, engagement, personal data. Company properties describe an organization — size, industry, revenue, tech stack. Information that applies to the whole company (annual revenue, employee count, industry) belongs on the company object, not duplicated on every contact. HubSpot automatically associates contacts to companies and you can reference company properties from contact-level workflows and reports.
Should I use text or dropdown for custom properties?
Default to dropdown or checkbox whenever the value is categorical. Open text is only appropriate for truly unique values — job titles, specific notes, free-form descriptions. Dropdowns give you clean reporting, segmentable lists, and consistent automation triggers. Text fields make all three of those harder because every typo or formatting variation creates a separate “value” in reports.
Can you bulk-edit custom properties in HubSpot?
Yes. In any contact, company, deal, or ticket list view, select multiple records and click “Edit” at the top. You can update one or more custom properties across the selection in a single action. For large-scale updates across thousands of records, use an import with the “Update existing records” option — this respects property types and won’t overwrite with blank values.
Do custom properties sync across HubSpot hubs?
Yes. Custom properties live on the core CRM layer, which is shared across Marketing Hub, Sales Hub, Service Hub, and CMS Hub. A custom contact property you create in Sales Hub is immediately usable in Marketing Hub workflows, Service Hub ticket automation, and CMS Hub personalization tokens. This shared database is the core architectural advantage of HubSpot over modular CRM ecosystems.
Build the Foundation Before You Scale
Custom properties look like a small setup task. In reality they’re the schema your entire revenue engine runs on — every workflow, every report, every piece of sales automation references them. Get the foundation wrong and you’ll rebuild everything 18 months from now.
If you’re setting up HubSpot for the first time or migrating from another CRM, the configuration decisions you make in week one affect everything that follows. Book a call with Your HubSpot Expert — we’ll build your property architecture before you touch a single setting, so you start with a CRM that’s ready to scale.