Construire une nomenclature de propriétés maintenable

Nous avons plusieurs centaines de propriétés et personne ne sait plus laquelle utiliser. Comment reprendre la main ?

Trois règles suffisent, et la première est la seule qui soit vraiment contraignante.

Le nom interne n'est jamais modifiable. Écrivez-le comme s'il devait durer dix ans, parce que c'est le cas. Le nom affiché, lui, reste modifiable à tout moment.
Un préfixe par domaine fonctionnel, pour que le tri alphabétique regroupe ce qui va ensemble. La liste des propriétés se trie par nom, donc le préfixe fait le travail.
Une propriété inutilisée s'archive, elle ne s'accumule pas. L'archivage n'est pas bloqué par le taux de remplissage.

Et une règle de méthode. Décidez sur quel objet vit un indicateur avant de le créer, parce qu'une propriété calculée ne franchit pas la frontière de son objet.

Le piège à connaître. Archiver une propriété la retire silencieusement des vues et des rapports qui l'utilisaient, sans blocage ni avertissement. Et elle est purgée définitivement au bout de quatre-vingt-dix jours.

Pourquoi le nom interne d'une propriété n'est jamais modifiable

La contrainte structurante est l'immuabilité du nom interne. Il est utilisé par les intégrations et l'API, et il ne se modifie pas. Le type de l'objet non plus. Une erreur de nommage se paie donc par la création d'une nouvelle propriété, une reprise des données, et une mise à jour de toutes les intégrations.

Le type se change, mais c'est destructeur. La documentation avertit que changer le type d'une propriété existante peut invalider les valeurs stockées, et recommande d'exporter avant. Deux types sont même des culs-de-sac, on ne peut ni convertir une propriété vers un score ou un calcul, ni convertir un score ou un calcul vers autre chose.

L'archivage est plus sûr qu'on ne le croit, et plus définitif aussi. Une propriété archivée reste récupérable, mais elle est purgée définitivement au bout de quatre-vingt-dix jours. Et l'archivage produit un effet silencieux, la propriété est retirée des actifs qui l'utilisaient, donc une vue ou un rapport perd sa colonne sans avertissement.

Les propriétés calculées imposent une décision d'architecture précoce. Une équation personnalisée n'accepte que des propriétés du même objet. Un indicateur qui doit croiser des données de contact et de transaction n'est donc pas une propriété calculée, c'est un rapport ou un workflow.

Et un seul champ vide vide tout le résultat, même si l'équation contient une constante. Il faut envelopper la formule dans un test de présence.

Deux plafonds à connaître. Mille propriétés personnalisées par objet en Professionnel et Entreprise, mais seulement dix au total sur un compte Starter, ce qui est un plafond de compte et non par objet. Et deux cents propriétés calculées.

En pratique, poser une convention de nommage tenable

La convention que nous recommandons

Un préfixe de domaine, puis un libellé explicite au singulier, sans abréviation maison. Par exemple un préfixe pour le contrat, un pour la facturation, un pour le marketing. Le tri alphabétique de la liste des propriétés fait alors apparaître les familles.

Faire l'inventaire avant de nettoyer

Allez dans Paramètres, Propriétés, puis exportez.
L'export contient l'utilisateur qui a créé chaque propriété, ses usages et son taux de remplissage. Ces trois colonnes suffisent à identifier ce qui ne sert à rien.
Dans la liste, filtrez par groupe, type de champ ou utilisateur créateur pour retrouver les propriétés d'un chantier passé.

Archiver proprement

Vérifiez la colonne des actifs qui empêchent l'archivage, typiquement des workflows.
Pour les autres actifs, sachez que la propriété en sera retirée sans blocage. Prévenez donc les propriétaires de vues et de rapports.
Comptez quatre-vingt-dix jours avant la purge définitive.

Repérer ce qui ne sert à rien

Le centre de qualité des données expose des compteurs de propriétés en doublon, sans données et inutilisées, mis à jour chaque jour.

À surveiller sur la nomenclature des propriétés HubSpot

Le nom interne est définitif. Faites-le relire avant de valider.
Changer le type peut invalider les valeurs. Exportez avant.
Score et calcul sont des culs-de-sac dans les deux sens.
Une propriété archivée est purgée à quatre-vingt-dix jours et devient irrécupérable.
L'archivage retire silencieusement la propriété des vues et rapports qui l'utilisaient.
Une propriété calculée ne croise que des propriétés du même objet, et un seul champ vide vide le résultat.
Attention au piège d'unité, les durées et les moyennes sont stockées en millisecondes.
Masquer une propriété la retire des compteurs de qualité. C'est pratique et trompeur.

Quand nous contacter sur la nomenclature des propriétés HubSpot

Contactez Yuzu Corp pour un audit de vos propriétés. L'export qui donne le créateur, les usages et le taux de remplissage suffit le plus souvent à identifier en une séance ce qui peut partir sans risque.

Pour aller plus loin, découvrez le cas Thiga, audit, refonte et gouvernance HubSpot.

Auteur, sources et date de vérification

Rédigé par Marin Desgrées du Loû Atias
Sales Ops chez Yuzu Corp · 3 ans sur HubSpot · Nantes & Paris
Yuzu Corp est partenaire HubSpot Diamond et membre du Claude Partner Network
Publié le 31 août 2026 · Vérifié sur HubSpot le 31 août 2026