Création d’un attribut supplémentaire

Créer un attribut supplémentaire : un champ de plus sur les fiches (tiers, produits, devis…) ou sur les lignes des documents, sans développement.


Dolibarr · attribut supplémentaire
01 / 09
Procédure pas à pas

Ajouter
un champ
à vos fiches
Dolibarr.

Créer un attribut supplémentaire : un champ de plus sur les fiches (tiers, produits, devis…) ou sur les lignes des documents, sans développement.

ÉditionOctobre 2026
AudienceAdministrateurs Dolibarr
VersionsDolibarr 18 à 24
02 / 09
Le parcours

Un formulaire, cinq minutes.

Chaque module de Dolibarr permet d’ajouter ses propres champs à ses fiches. L’exemple de ce guide ajoute un « Secteur d’activité », sous forme de liste, sur les fiches des tiers.

  1. Créer l’attribut~3 min
  2. Le retrouver sur les fiches1 min
  3. Les champs du formulaire3 min
  4. Les types d’attribut2 min
  5. En cas de problème4 cas
Créer l’attribut 03 / 09
Étapes 1 et 2

Ouvrir le bon onglet, puis le formulaire.

  1. Accueil → Configuration → Modules/Applications
    Ouvrir les attributs supplémentaires du module

    Cliquez sur la roue dentée du module concerné (ici Tiers), puis sur l’onglet Attributs supplémentaires voulu. Un module en a souvent deux : un pour les fiches, un pour les lignes des documents ou pour un objet voisin (ici les contacts).

    Onglets de la configuration du module Tiers, onglet Attributs supplémentaires (tiers) entouré en rouge
    Fig. 02 — Onglet Attributs supplémentaires
  2. Attributs supplémentaires
    Cliquer sur « + »

    Le bouton +, à droite du titre, ouvre le formulaire de création.

    Barre de titre des attributs supplémentaires des tiers, bouton plus entouré en rouge
    Fig. 03 — Nouvel attribut
Créer l’attribut 04 / 09
Étapes 3 et 4

Remplir le formulaire, puis enregistrer.

  1. Nouvel attribut
    Nom, code, type et valeurs

    Saisissez le Libellé affiché à l’écran, un Code en minuscules sans espace, puis le Type. Pour une liste, tapez une valeur par ligne sous la forme clé,libellé, la clé ne pouvant pas être 0.

    Formulaire rempli : libellé Secteur d'activité, code secteur, type Liste de sélection, valeurs Commerce, Artisanat, Services, entourés en rouge
    Fig. 04 — Libellé, code, type et valeurs

    Plus bas, réglez au besoin les options, par exemple Obligatoire, Visibilité et Sur les PDF (détail dans « Les champs du formulaire »).

    Options de l'attribut : Obligatoire, Visibilité et Sur les PDF entourés en rouge
    Fig. 05 — Options
  2. Bas du formulaire
    Enregistrer
    Bouton Enregistrer entouré en rouge, à côté du bouton Annuler
    Fig. 06 — Enregistrer

    L’attribut apparaît dans la liste, avec ses réglages. Le crayon permet de le modifier, la corbeille de le supprimer.

    Liste des attributs supplémentaires des tiers, ligne secteur, Liste de sélection, entourée en rouge
    Fig. 07 — L’attribut créé

Le code ne se change plus après la création. Choisissez-le bien : il sert aussi à recopier la valeur d’un document à l’autre (voir « Les champs du formulaire »).

05 / 09
Le résultat

Le champ sur les fiches.

Le nouveau champ apparaît sur toutes les fiches du module. Sur une fiche de tiers en modification, les attributs supplémentaires sont regroupés dans la partie « Plus », à déplier.

Lien Plus suivi de trois points, entouré en rouge
Fig. 08 — Déplier la partie Plus
Champ Secteur d'activité sur la fiche du tiers, liste réglée sur Commerce, entourée en rouge
Fig. 09 — Le champ Secteur d’activité
06 / 09
Référence

Les champs du formulaire.

Seuls le libellé, le code et le type sont obligatoires. Le petit « i » de certains champs affiche leur aide dans Dolibarr.

Champ
À quoi il sert
Bon à savoir
Libellé
Le nom affiché à l’écran et sur les PDF.
Peut être une clé de traduction
Code de l’attribut
L’identifiant du champ, en minuscules, sans espace ni caractère spécial.
Même code sur deux objets (devis et commande, par exemple) : la valeur est recopiée quand l’un est créé à partir de l’autre
Taille, Valeur
Le nombre de caractères maximum ; la liste des valeurs possibles pour les types liste.
Selon le type
Position
L’ordre des attributs entre eux.
Toujours après les champs standards
Valeur par défaut
La valeur proposée à la création d’une fiche.
Selon le type
Unique, Obligatoire
Une même valeur une seule fois ; une saisie imposée.
Selon le type
Modifiable pour tout état
Décoché, la valeur ne se modifie que tant que le document est en brouillon.
Coché par défaut
Valeur nulle au clonage
La valeur est vidée quand on clone la fiche.
Pour un numéro propre à chaque fiche
Contient des données personnelles
Signale que le champ contient des données personnelles.
À cocher pour un nom, une date de naissance…
Visibilité
0 : jamais ; 1 : listes et formulaires ; 2 : listes seulement ; 3 : formulaires seulement ; 4 : listes, modification et consultation, pas en création ; 5 : liste et consultation seulement.
Valeur négative : absent des listes par défaut, mais ajoutable
Sur les PDF
Fiche : 0 non affiché, 1 affiché, 2 affiché s’il n’est pas vide. Lignes : 0 non, 1 dans une colonne, 3 après la description, 4 après la description s’il n’est pas vide.
Sur les modèles de PDF compatibles
Infobulles, Sommable, Texte d’aide
Montrer le champ dans les infobulles ; totaliser la colonne en bas des listes ; afficher une aide au survol du champ.
Sommable : types numériques
Champ calculé, Invite IA, CSS
Une valeur calculée par une formule ; une valeur fournie par l’intelligence artificielle à partir d’une consigne (module IA) ; la mise en forme du champ.
Usages avancés, à réserver aux intégrateurs
07 / 09
Référence

Les types d’attribut.

Le type détermine la saisie proposée à l’utilisateur. Dolibarr 24 en propose 24.

Famille
Types
Exemple d’usage
Texte
Chaîne de caractères (1 ligne), Texte long (n lignes), Texte HTML, Mot de passe
Une référence interne, une note mise en forme
Nombres
Numérique entier, Décimal, Prix, Prix avec devise, Étoiles
Un effectif, un budget, une note sur 5
Dates
Date, Date et heure, Durée
Une date d’audit, un temps passé
Coordonnées
Téléphone, Email, Url, IP
Le contact d’astreinte, le site d’un partenaire
Choix
Boolean (case à cocher unique), Radio bouton (1 choix uniquement), Liste de sélection, Liste de sélection (n choix)
Un secteur d’activité, des centres d’intérêt
Liens
Liste issue d’une table, Liste issue d’une table (n choix), Lien vers un objet
Le projet ou le tiers lié
Mise en page
Séparateur (il ne s’agit pas d’un champ de saisie)
Regrouper plusieurs attributs sous un titre
08 / 09
Avant d’ouvrir un ticket

En cas de problème.

INVISIBLE
Le champ n’apparaît pas sur la fiche

Pourquoi : il est rangé dans une partie à déplier (« Plus » sur les tiers), ou sa visibilité l’exclut de cet écran.

Que faire : déplier la partie, sinon vérifier la valeur de Visibilité (1 pour partout).

NON RECOPIÉ
La valeur du devis ne passe pas sur la commande

Pourquoi : les deux attributs n’ont pas le même code.

Que faire : créer sur la commande un attribut avec exactement le même code que sur le devis.

PDF
Le champ n’est pas sur le PDF

Pourquoi : « Sur les PDF » vaut 0, ou le modèle de PDF ne gère pas les attributs supplémentaires.

Que faire : mettre 1 ou 2, régénérer le PDF ; sinon, voir avec ATM pour adapter le modèle.

CODE
Le code a une faute de frappe

Pourquoi : le code ne se modifie plus après la création.

Que faire : supprimer l’attribut (ses valeurs saisies sont perdues) et le recréer.

09 / 09
Fin du document

Un libellé,
un code,
un type.

Un attribut supplémentaire se crée dans la configuration du module, en quelques champs. Bien choisir son code, c’est permettre à la valeur de suivre d’un document à l’autre.

Captures : Dolibarr 24.0.2, données fictives
Formulaire enrichi au fil des versions, depuis la 18
Dernière revue : octobre 2026