> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://katalyz.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Créer des propriétés personnalisées

Les **propriétés personnalisées** vous permettent d'étendre le modèle de données de Katalyz avec des champs qui correspondent à la façon dont votre entreprise fonctionne réellement — montants de deals, dates de clôture, scores de prospects, secteurs d'activité, ou tout autre élément que vous souhaitez suivre par espace.

Une fois définies, les propriétés personnalisées peuvent être :
* Affichées dans les espaces via le **Widget Champ**
* Référencées en tant que **variables** (tapez `$` dans un widget texte) pour personnaliser le contenu par espace
* Mappées aux champs **HubSpot** (ou autre CRM) pour une synchronisation bidirectionnelle

> ⚠️ Nécessite le rôle d'organisation **Admin**. Allez dans **Paramètres de données**.

## Les quatre types d'objets

Katalyz regroupe les propriétés par **objet** auquel elles appartiennent :

| Type d'objet | Ce qu'il représente | Exemples de propriétés |
| ---- |
| **Espaces** | Données au niveau du deal sur un espace | Montant du deal, étape du deal, date de clôture, score du prospect |
| **Contacts** | Personnes de votre CRM qui interagissent avec les espaces | Email, téléphone, poste, domaine de l'entreprise |
| **Participants** | Personnes que vous avez invitées dans un espace spécifique | Rôle, dernière connexion, segment d'activité |
| **Actions** | Tâches et étapes au sein des espaces | Priorité, date d'échéance, statut, assigné |

Chaque objet dispose de son propre onglet dans les Paramètres de données.


![](https://storage.crisp.chat/users/helpdesk/website/-/5/5/4/8/554891f22af0b400/katalyz-custom-objects_27t9hx.png)


## Types de champs pris en charge

| Type de champ | À utiliser pour |
| ---- |
| **Texte sur une ligne** | Noms, identifiants courts |
| **Texte multi-lignes** | Notes, descriptions |
| **Nombre** | Décomptes, scores |
| **Devise** | Montants de deals, valeurs de contrats |
| **Sélecteur de date** | Dates comme la date de clôture, le renouvellement |
| **Liste déroulante (sélection unique)** | Statut, étape, niveau |
| **Téléphone** | Numéros de téléphone |
| **Utilisateur** | Lien vers un membre Katalyz |

## Créer une propriété

1. Allez dans **Paramètres de données**.
2. Choisissez l'onglet du type d'objet (Espaces, Contacts, Participants ou Actions).
3. Cliquez sur **+ Ajouter une propriété**.
4. Vous avez trois options :
* **Créer de zéro** — définir une nouvelle propriété native à Katalyz
* **Importer depuis une intégration** — récupérer un champ HubSpot/Salesforce existant dans Katalyz
* **Importer depuis un fichier** — import en masse de définitions de propriétés
5. Pour « créer de zéro », renseignez :
* **Nom de la propriété** (libellé lisible)
* **Nom interne** (généré automatiquement, utilisé dans les placeholders et l'API)
* **Type de champ**
* **Description** (facultatif)
6. Enregistrez.


![](https://storage.crisp.chat/users/helpdesk/website/-/5/5/4/8/554891f22af0b400/katalyz-property-popup_jj419a.png =478xauto)


## Colonne Origine

Chaque propriété affiche une **origine** :

* **Katalyz** — créée directement dans Katalyz
* **Importée depuis HubSpot** — à l'origine une propriété HubSpot, désormais disponible dans Katalyz via l'intégration
* **Importée depuis Salesforce** — pareil, depuis Salesforce

Les propriétés importées depuis un CRM sont déjà liées à leur champ source.

## Mappage vers les champs CRM

Toute propriété Katalyz peut être mappée à un champ d'intégration externe (HubSpot, Salesforce).

La colonne **Mappée avec** dans le tableau des propriétés indique le mappage actuel :
* Vide (non mappée) — la propriété existe uniquement dans Katalyz
* `HubSpot / deal_amount` — mappée au champ `deal_amount` dans HubSpot

Pour mapper ou modifier un mappage, cliquez sur la ligne → **Modifier la propriété** → sélectionnez une intégration et un champ.

Certains champs ont `canEditMapping: false` — typiquement des propriétés qui ont été importées depuis HubSpot et qui doivent rester liées à leur origine. Les modifier romprait la synchronisation.

## Suivi d'utilisation

La colonne **Utilisée dans** indique combien d'espaces utilisent activement chaque propriété. Cela vous aide à :

* Voir quelles propriétés votre équipe utilise réellement
* Identifier les candidates au nettoyage (propriétés avec 0 utilisation)
* Évaluer l'impact d'une suppression (une propriété utilisée dans 57 espaces représente un engagement important à retirer)

## Utiliser des propriétés personnalisées dans les espaces

Une fois définie, une propriété peut alimenter :

### Widget Champ
Ajoutez un bloc Champ à un espace. Liez-le à une propriété personnalisée. Le widget affiche la valeur actuelle.

### Placeholders
### Variables dans les widgets texte
Tapez `$` dans un widget texte pour insérer une propriété sous forme de variable. La variable est remplacée par la valeur réelle lors du rendu de l'espace.

Voir [Utiliser des variables dans le texte](https://katalyz.crisp.help/fr/article/utiliser-les-variables-dans-le-texte-r8bzkr/).

## Modification et suppression

* **Modifier** — changez le libellé, la description ou le mappage de la propriété. Le type de champ ne peut généralement pas être modifié (cela corromprait les valeurs existantes).
* **Supprimer** — retire la propriété de tous les espaces et de tous les modèles qui l'utilisent. Les widgets et placeholders qui la référencent ne fonctionneront plus.

Avant de supprimer, vérifiez le compteur **Utilisée dans**. Une propriété utilisée dans des dizaines d'espaces doit être retirée progressivement — mettez à jour les espaces concernés au préalable.

## Articles liés
* [Mappage des champs HubSpot](https://katalyz.crisp.help/fr/article/mapping-et-synchronisation-des-champs-crm-hubspot-salesforce-q9h678/)
* [Utiliser des variables dans le texte](https://katalyz.crisp.help/fr/article/utiliser-les-variables-dans-le-texte-r8bzkr/)
* [Widget Champ](https://katalyz.crisp.help/fr/article/widget-champ-lo50zy/)