HubSpot delete custom property: who signs off first

Key takeaways
To check whether a HubSpot custom property is safe to delete, clear the assets HubSpot lists, then ask a named owner whether any integration or export reads its internal name. Archive the property first, keep it archived for one reporting cycle inside HubSpot's 90-day restore window, and delete last.

How do you check whether a custom property is safe to delete in HubSpot? Clear what HubSpot’s usage view lists, then ask a named owner whether anything outside HubSpot reads the field; if nobody can answer, archive it instead of deleting it.

HubSpot will tell you which of its own tools still use the property. It will not tell you which integration, finance export or board report still reads it every night. Here are both halves of a HubSpot delete custom property decision, as of November 2026.

What HubSpot shows before you delete a custom property

HubSpot shows where a property is used inside HubSpot and how many records hold a value. In the property editor, the Monitor section has a Usage view (where the property appears in the CRM, plus its fill rate) and a Data sources view listing the tools that update the property, according to HubSpot’s property editor guide.

When you archive a property that is in use, a right-hand panel splits its usage into two groups, as described in HubSpot’s guide to organizing and exporting properties. Assets preventing archiving, such as segments, forms or a workflow Edit record action, must be changed first, and each has a Review link. Other assets, such as an index page column, simply lose the property. A property can be archived even when records still hold values.

For a portal-wide view, the Data Model Health Check (Data Management, then Data Model, then the Health tab) flags properties as Low fill rate, Inactive property, Similar (duplicate) property or Low fill rate, high usage, with actions such as Review usage and Archive. HubSpot does not publish the thresholds behind those flags, so treat them as a shortlist.

What the usage view cannot see

The usage view cannot see outside systems that read the property. Every HubSpot property has an internal name used for integration app sync and API calls, and the internal name cannot be changed after the property is created. Integrations, warehouse syncs and finance scripts request that internal name directly.

The Data sources view lists tools that update a property. A system that only reads the property leaves no trace there. A property with nothing blocking the archive can still feed your CFO’s monthly revenue report. HubSpot’s view answers “which HubSpot assets use this property”. The question that protects you is “who outside this portal depends on it”.

How to retire a HubSpot custom property safely

  1. Export first. Open the settings icon, then Properties, hover over the property and click More, then Export property definition. The ZIP holds three CSV files, including usage in HubSpot tools. Export the record values too if anyone may need them later.
  2. Clear what HubSpot lists. Click More, then Archive, and use the Review links under Assets preventing archiving to fix each workflow, form or segment. Moving values into a replacement property first is a bulk update, covered in bulk updating HubSpot properties.
  3. Ask the owner by name. Ask whoever runs your integrations and reports whether any system reads the property’s internal name. Write the answer and the owner’s name in the property’s Documentation section.
  4. Archive, do not delete. Archived properties move to the Archived tab, and a user with Edit property settings permission can restore them.
  5. Wait one reporting cycle. Keep it archived through one month-end close or board report. HubSpot permanently deletes archived properties after 90 days, so the wait must fit inside that window.
  6. Delete last. If nobody missed it, a Super Admin can permanently delete it from the Archived tab.

Our take

“Is it safe to delete” sounds like a technical question. It is an ownership question, and HubSpot cannot answer it for you.

The question we hear is “is this property safe to retire”, but the answer is an owner’s decision, not a HubSpot setting. HubSpot’s check covers HubSpot’s own tools; the finance export, the integration mapping and the board report built outside HubSpot are not in that view. Our rule: name an owner for every property, archive before you delete, and keep it archived for one full reporting cycle.

The clicks take minutes. The hours go into finding out who reads what, and that work is done once: after it, every property has an owner written in its Documentation section, and the next cleanup is quick. Where properties fit in a wider cleanup is in the HubSpot CRM cleanup order.

A portal with only native HubSpot apps and one admin who built every property does not need this process; the usage view plus a short archive period is enough. The rule pays off when several teams, integrations or past admins have touched the property list.

HubSpot admin

No one owns HubSpot on your team?

We run your portal week to week: users, data, workflows, reports.

See how it works

FAQ

Can I restore a deleted custom property in HubSpot?

Yes, if the property was archived less than 90 days ago. Open the Archived tab in property settings, select the property and click Restore; you need Edit property settings permission. Properties archived 90 or more days ago have been deleted and cannot be restored.

Why can’t I delete a custom property in HubSpot?

A HubSpot asset still uses the property. Segments, forms and workflows block archiving until you remove the property from them, and the archive panel links to each one under Assets preventing archiving. A property that is not in use can be deleted permanently without archiving it first.

Will I lose data if I delete a HubSpot property?

Plan as if you will. HubSpot’s guide does not describe what happens to stored values, so export the values before you archive. Archiving keeps a 90-day way back; a permanent delete does not.

This week, pick the one property you most want gone, export it and ask who owns it. If nobody can answer within a day, archive it, write the date in its Documentation section and come back after month-end.

Alignify

Alignify is a HubSpot implementation and admin team. We set up portals, clean up CRM data and run HubSpot as a service for B2B companies.

On this page

Get the audit checklist

All 25 checks as a spreadsheet with auto-scoring.

By submitting, you agree to our Privacy Policy.

Talk to Alignify

45 minutes, your portal on screen, no slides. We show what we would fix first.

Want a second set of eyes on your HubSpot?

Book a 45-minute portal review. We look at your portal together on a screen share and show what we would fix first. No slides, no sales pitch.