On this page
What HubSpot supports natively
HubSpot now calls the first step of deleting a property “archiving”. When you archive a custom property, its side panel splits the property’s usage into three groups:
| What the panel shows | Blocks archiving? | What happens on archive |
|---|---|---|
| Fill rate: the share of records with a value | No | Values go with the property when it’s permanently deleted |
| Assets preventing archiving, such as workflows, forms, segments or property cards | Yes | You must update each asset first; Review assets takes you to them |
| Other assets using this property, such as a column in an index page view | No | HubSpot removes the property from them |
So “in use” means at least one asset in the blocking group still depends on the property. HubSpot won’t guess how to rewrite a workflow branch or a segment filter for you, so the property stays until you change those assets.
Archived properties sit in the Archived tab for 90 days, then HubSpot deletes them permanently. Archiving needs Edit property settings permissions. Permanently deleting from the Archived tab needs Super Admin.
How to remove a property that’s in use
- Open the property. Go to Settings > Properties, pick the object, hover over the property and choose Archive from the More menu.
- Read the panel before you act. Note the fill rate and every asset under Assets preventing archiving. If you want a record of everything that uses it, export the property definition first: More > Export property definition gives you a ZIP that includes a usage file with a link to each asset.
- Decide what replaces it. For each blocking asset, either delete the condition or action that uses the property, or switch it to the property you’re keeping. Don’t just delete a workflow branch without checking what records it was routing.
- Update the assets. Edit workflows, forms, segments and property cards one by one. Re-open the archive panel until the blocking list is empty.
- Save the data if it matters. Export the property’s values or its property history before archiving.
- Archive, then wait. Leave it in the Archived tab for a while before a Super Admin deletes it permanently, so anything you missed can be restored.
Common mistakes
- Replacing a property without moving its values. If you’re consolidating two properties, copy the values across (an import or a workflow) before you repoint the assets.
- Forgetting the workflows that set the property. A workflow that writes to a property is just as dependent as one that reads it. Check enrollment triggers, branches and “edit record” actions; see which workflows use a property.
- Archiving during a live campaign. Forms and segments behind active campaigns are often the blockers. Change them when the campaign is paused or finished.
Where Jetstack AI fits
Jetstack AI’s Portal Audit reports property sprawl, including custom properties with no data or no usage in forms, workflows, lists or reports, so you can see the whole cleanup list instead of one property at a time. Its Workflow Audit traces which workflows read or write the same properties. Neither changes anything in HubSpot; you still archive properties yourself. See the Property Management data points.
Sources
- Organize, archive and export properties (HubSpot Knowledge Base)
- Create and edit properties (HubSpot Knowledge Base)
- Portal Audit: General data points (Jetstack AI documentation)
Checked October 29, 2026. HubSpot changes its products often; tell us at team@jetstack.ai if something here is out of date.
HubSpot admin
See what needs work before you change it.
A read-only Portal Audit and Workflow Audit score the portal, trace dependencies and turn findings into a branded report.
Explore Portal Audit