cleanup-properties

Archive or delete unused custom properties across HubSpot object types.

58|16|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill cleanup-properties
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cleanup-properties
Source: https://github.com/TomGranot/hubspot-admin-skills/tree/main/skills/cleanup-properties
Command: npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill cleanup-properties

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive or delete unused custom properties across all HubSpot object types (contacts, companies, deals) to reduce property sprawl, improve data quality, and simplify forms and automations.

Core Features & Use Cases

  • Inventory and classify properties by usage, dependencies, and source (including Salesforce sync properties and form fields).
  • Safe archive and deletion with rules, fallback archiving, and rollback logging.
  • Applicable across all object types (contacts, companies, deals) to support ongoing cleanup and governance.

Quick Start

Run the cleanup-properties skill to inventory all HubSpot properties and begin archiving or deleting unused ones.

Frequently Asked Questions about cleanup-properties

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify and clean up unused custom properties in HubSpot?

This Skill inventories all HubSpot properties across contacts, companies, and deals, classifies them by usage and dependencies, and applies a safe archival-first workflow to remove obsolete custom fields and reduce property sprawl.

What is the safest way to archive or delete obsolete HubSpot contact properties?

The safest approach uses an archival-first deletion workflow with dependency validation, fallback archiving, and rollback logging to ensure an auditable and reversible cleanup process for obsolete contact fields.

Do I need a HubSpot API token to run property archival and deletion workflows?

Yes, a HubSpot API token is required to inventory properties, validate workflow dependencies, classify Salesforce sync fields, and execute the archival or deletion workflow across your portal.

Can I find and remove Salesforce sync properties and test fields during a HubSpot portal maintenance cleanup?

Yes, the cleanup process specifically identifies Salesforce sync properties, test/temp properties, and obsolete form fields to determine whether they are safe candidates for archival or deletion.

What happens if a HubSpot property has active workflow dependencies during cleanup?

If active workflow dependencies are detected, the process applies safeguards and dependency validation to prevent breaking automations, defaulting to fallback archiving rather than permanent deletion.

Why does HubSpot property sprawl affect data quality and how do I fix it?

Property sprawl degrades data quality by cluttering forms and automations with obsolete fields; you fix it by inventorying all object properties and archiving unused ones to simplify portal governance.