How to bulk create custom properties in HubSpot from a CSV or spreadsheet
English · Deutsch · Español · Français · Português
By Kayabyte
You are setting up a new HubSpot account, or a client’s, and need 40 custom properties with groups and dropdown options. HubSpot has no “import properties” button. The Community has had a long-running request for bulk property creation, and in June 2026 a HubSpot product manager said there were no plans for it (Community thread). These are the routes that exist.
Short answer
HubSpot has no import for properties. You can create them one by one, create them while importing records, call the Properties API batch endpoint with a script, or use an app that reads a CSV or Google Sheet and previews the batch first. Internal names cannot be changed after creation, so check the file before you create anything.
Route 1: create them one by one
Settings > Properties > Create property. Pick object, group, label and type. HubSpot does not let you change a property’s internal name after it is created, so check it before saving. Fine for a handful. For dropdowns, Load options pastes a whole list (HubSpot guide).
Route 2: create them while importing records
On the import mapping step, Create new property sets up a property for a column (HubSpot guide). It is one property per column, configured by hand in a side panel, and it is meant for importing records, not for setting up an empty account. Dropdown options need to exist before the import.
Route 3: the Properties API
HubSpot’s API has a batch create endpoint (POST /crm/properties/2026-03/{objectType}/batch/create). Each property needs a name, label, type, field type and group. You need a private app token with the schema write scope for the object, plus a script or a tool such as Zapier that reads your spreadsheet. It is the most flexible route and also the one that needs a developer, and you handle groups, option order and error messages yourself.
Route 4: ask an AI tool
HubSpot’s data agent and Breeze Assistant can create a property from a description (HubSpot guide). Still one property at a time, so it saves clicks rather than setup hours.
What to prepare in the spreadsheet either way
One row per property: object, internal name, label, type, field type, group, and for dropdowns the options with the internal value you want. Decide the internal values now, because they cannot be changed later.
Before you import, you can check the file for the usual mistakes (internal names, type and field type pairs, dropdown options) with the free HubSpot property CSV checker. It runs in your browser and nothing is uploaded. Full disclosure: we made it, as well as the app below.
Full disclosure: we built an app for this
Bulk Property Import & Export reads a CSV or a public Google Sheet with one row per property (object, internal name, label, type, group, options, with “Label|value” for a specific internal value) and shows a preview of the whole batch first: what will be created, updated or left alone, with a reason for every problem row. Nothing is written until you click Apply, and a results report shows what HubSpot said for each row. It creates groups too, works for contacts, companies and deals, and asks for property settings access only, never your records. It cannot change the locked default properties.
Import, export and preview are free. Pro is USD 19 per month per HubSpot account and Agency is USD 49 per month for unlimited client accounts; every new account gets a 14-day Pro trial with no card. Marketplace listing.
FAQ
Can you bulk import custom properties into HubSpot? Not with HubSpot’s own import tool, which imports records. Use the Properties API batch endpoint or an app.
Can I upload a CSV to create properties in HubSpot? Not natively. The API reads JSON; an app can read your CSV and call the API for you.
Is there a limit on dropdown options? HubSpot documents up to 5,000 options per property.
Questions or corrections: support@kayabyte.dev. HubSpot is a registered trademark of HubSpot, Inc. Kayabyte is an independent developer and is not affiliated with HubSpot.
More guides
- How to audit and clean up HubSpot properties without breaking anything
- How to stop a HubSpot deal reaching Closed won until it is approved
- Bulk create HubSpot properties: Lift vs Schema Replicator vs Bulk Property Import & Export
- How to calculate MRR from Paddle: yearly, weekly, discounts and tax
- How to send a client an hours statement from HubSpot
- How to copy properties from one HubSpot account to another
- DealHub or a lightweight approval app for HubSpot deals?
- How to download all attachments in HubSpot
- How to download email attachments from HubSpot records
- How to export all properties from HubSpot, with their dropdown options
- Export files from HubSpot: library vs attachments
- Export ticket and deal attachments from HubSpot
- Find sensitive files in HubSpot attachments
- HubSpot API: get attachments from notes and emails
- HubSpot attachment export tools compared
- How to bulk add dropdown options (and properties) in HubSpot
- HubSpot deal approval options compared: native approvals, workflows, DealGuard and Deal Approvals & Stage Gate
- HubSpot deal approvals without Enterprise: what Free, Starter and Professional can do
- HubSpot discount approval on Sales Hub Professional or Starter
- How to set up discount approvals in HubSpot (deal desk)
- HubSpot GDPR request: export a contact’s files
- How to see how many contacts were in each HubSpot lifecycle stage last month
- HubSpot migration: export attachments checklist
- How to see what your HubSpot pipeline looked like last week
- How to track prepaid hours and retainers in HubSpot
- Creating HubSpot properties in bulk: HubSpot import, the API, Lift and Bulk Property Import & Export compared
- HubSpot property naming conventions: a template for internal names, groups and labels
- How to create a top-up deal when a client’s retainer runs low in HubSpot
- Tracking retainer hours in HubSpot: StopWatch, PSOhub, a spreadsheet or Retainer Wallet
- A weekly stale-deal report in HubSpot, without Enterprise
- Time tracking on HubSpot tickets: what HubSpot has and the options
- HubSpot workflows for failed Paddle payments, cancellations and ending trials
- Insycle or Bulk Property Import & Export for HubSpot properties?
- Paddle to HubSpot: Paddle’s own HubSpot integration vs ChartMogul vs Paddle Sync
- Paddle and HubSpot without Zapier: webhooks, Make and other options
- How to require approval before a deal moves stage in HubSpot
- How to require fields before a HubSpot deal moves to a stage
- Retainer rollover rules: expire, capped or full, with examples
- RevOps Deal Desk & CPQ vs Deal Approvals & Stage Gate for HubSpot
- How to show MRR on HubSpot contacts and companies
- How to stop reps skipping deal stages or moving deals backward in HubSpot
- How to sync Paddle subscriptions to HubSpot
- Export property history in HubSpot: who changed it and when
- How to track a retainer balance per client in HubSpot