Skip to content
Book a build

Can I change a HubSpot property's internal name or field type?

You can't change a HubSpot property's internal name or object type after it's created; only the label and settings are editable. You can change the field type, but HubSpot warns it can invalidate stored values and score or calculation types can't be switched. To change the internal name, create a new property, copy the values across, repoint every asset that uses the old one, then archive it.

On this page

What HubSpot supports natively

ChangeAllowed?What HubSpot says
LabelYesEdit any time
Internal nameNoCan’t be edited after creation
Object typeNoCan’t be edited after creation
Field typeYes, with careCan invalidate current values; export your data first
To or from Score / CalculationNoThose types can’t be converted in either direction
Text to dropdownYesEach unique text value becomes an option
Dropdown optionsYesOptions can be edited after creation
Properties in useLimitedSome edits are blocked on certain default properties and on properties used in records or tools

Field type changes can take up to 30 minutes to show everywhere in the account.

How to change a HubSpot property’s internal name

Because the internal name is fixed, “renaming” means replacing:

  1. Export the old property’s definition (More > Export property definition). The usage file lists every tool that uses it, with links.
  2. Create the new property with the right internal name, the same type and the same option values.
  3. Copy the values. Export records with the old property and Record ID, then import them into the new property. For live data, a workflow that copies the value on change can bridge the gap.
  4. Repoint every asset: workflows (triggers, branches and actions), forms, segments, reports, property cards and views.
  5. Update integrations that read or write the old internal name. They may not appear in HubSpot’s usage list.
  6. Archive the old property once nothing blocks it. See deleting a property that’s in use.

How to change a field type safely

  1. Export the property’s values first, or its property history.
  2. Normalise the values if you’re moving to a dropdown, so you don’t create near-duplicate options.
  3. Check workflows and filters that compare values; a number filter won’t work on a text field.
  4. Make the change and check a sample of records after 30 minutes.

Common mistakes

  • Creating lead_source_2. A replacement with a numbered name causes the confusion you were fixing; follow a naming convention.
  • Forgetting integrations. External systems break silently when an internal name disappears.
  • Changing types in a production portal first. Try it in a sandbox or on a test property.

Where Jetstack AI fits

Jetstack AI can’t rename internal names either, since HubSpot doesn’t allow it. When Portal reuse deploys a property and the destination already has one with the same internal name but a different type, it doesn’t overwrite it: it creates a separately named property and logs a warning so you can reconcile them. See how properties are deployed. For steps 2 and 4, Projects (currently in limited release) can build the correctly named property and corrected replacement workflows from a brief, with the workflows created switched off; copying the values stays an export and import you run, and you retire the old assets in HubSpot.

Sources

Checked October 29, 2026. HubSpot changes its products often; tell us at team@jetstack.ai if something here is out of date.

HubSpot admin

Take a proven setup to the next portal.

Import a setup with its dependencies, map it to the destination portal and deploy it with references rewritten.

Explore Portal reuse

HubSpot admin

Related questions.

Can I change a HubSpot property's internal name or field type?

You can't change a HubSpot property's internal name or object type after it's created; only the label and settings are editable. You can change the field type, but HubSpot warns it can invalidate stored values and score or calculation types can't be switched. To change the internal name, create a new property, copy the values across, repoint every asset that uses the old one, then archive it.

Why can't HubSpot let me rename the internal name?

Imports, workflows, integrations and the API refer to properties by internal name. HubSpot keeps it fixed so those references don't break. Change the label instead if only the wording is wrong.

What happens if I change a text property to a dropdown?

HubSpot creates an option for each unique text value, so variations like LinkedIn and linkedin become separate options. Clean the values before you switch.

How long does a field type change take?

HubSpot says it can take up to 30 minutes for the change and your data to be fully reflected across the account.