---
updatedAt: 2026-04-17T14:04:39.000Z
agentTools:
  projectIndex: https://docs.quable.com/llms.txt
---

# Créer et gérer la structure des fiches produits

> 📘 Objectifs pédagogiques
>
> * Comprendre le rôle des attributs dans la structure des fiches produits.
> * Savoir créer, organiser et gérer les niveaux hiérarchiques des fiches produits.
> * Apprendre à ajouter et paramétrer des attributs en tenant compte des besoins métier et des bonnes pratiques.

***

# Présentation

Dans le PIM , les attributs de la fiche produit portent toutes les informations essentielles : chaque attribut correspond à une donnée spécifique associée au produit. Cela peut être une caractéristique technique (poids, dimensions, matériau), un contenu marketing (description, images, vidéos) ou une information spécifiques à un canal de vente (SKU, délais de livraison).

L’organisation des attributs dans des structures logiques (onglets, rubriques, sections) est essentielle pour optimiser la navigation et la productivité des utilisateurs du PIM. Une fiche produit bien structurée permet aux équipes de trouver rapidement les informations, d’éviter les erreurs et de maintenir une qualité de données constante.

Les attributs sont donc la base de la fiche produit : ils définissent les caractéristiques d'un produit et servent de structure pour stocker ses informations. Leur création et leur organisation garantissent la centralisation des données et la performance de votre PIM Quable. Nous allons à présent voir pas à pas comment :

* Créer un nouveau type de document pour les fiches produits,
* Organiser ses niveaux hiérarchiques (onglets, sections, rubriques)
* Créer et gérer les attributs portés par la fiche produit.

Suivez ces instructions pour structurer efficacement vos données au sein des fiches produits.

<Callout icon="👍🏼" theme="default">
  ### Bon à savoir

  Dans ce cours, les termes "document" et "fiche produit" désignent le même objet. Une fiche produit est un document avec type de document spécifique, défini par l'administrateur.
</Callout>

***

<br />

# Créer un nouveau type de document

## Accéder à la page Attributs :

* Rendez-vous dans le menu d’administration et aller à la page **Modèle de données > Attributs**.

<Image align="center" width="30% " src="https://files.readme.io/0c6770f3c9a0ae7458e654574471ff2a232ee70330646bf3f8d7bf4f9c608cb3-Capture_decran_2025-01-27_a_10.20.31.png" />

* Assurez vous de sélectionner le type d’objet **document,**

<Image align="center" alt="Capture d’écran 2025-01-27 à 16.32.43.png" width="30% " src="https://files.readme.io/3fa4681e320d22ff47239f89878d5320484dca50355c4508d62bf5a1fe235a23-Capture_decran_2025-01-27_a_16.32.43.png" />

<br />

## Créer un nouveau type de document :

* Cliquez sur **Ajouter un type de document** en haut du panneau de droite.

<Image align="center" width="30% " src="https://files.readme.io/ebac61bd09cf56ed7a635b398387d09bb805b545051b968190df1d205a9cd133-Capture_decran_2025-01-27_a_10.21.07.png" />

* Remplissez le formulaire :
  * **Nom** (obligatoire) : Entrez un nom explicite pour identifier ce type de document,
  * **Code** (obligatoire) : Généré automatiquement ou modifiable selon les règles de nommage,
  * **Abréviation** (obligatoire) : choisissez en 2 lettres,
  * **Description** (facultatif) : Ajoutez une description du type de document,
  * **Variants** (obligatoire) : ce type de document va-t-il porter des variants ?

<Image align="center" width="50% " src="https://files.readme.io/70ceb0b02b2eb4eb81a83d2f2599bdd2aeeb28af6b29dd1aeb4d0c6d53e2d5c2-Capture_decran_2025-01-27_a_10.21.14.png" />

* **Sauvegarder** : cliquez sur **Ajouter** pour enregistrer le nouveau type de document.

<br />

<Callout icon="👍🏼" theme="default">
  ### Bon à savoir

  * Simplifiez les noms de vos types de documents : utilisez des noms explicites pour vos types de documents,
  * Anticipez les besoins futurs : prenez le temps de contrôler et de valider sa structure avant sa mise en production.
</Callout>

***

<br />

# Créer et paramétrer les niveaux

Les niveaux hiérarchiques permettent de structurer vos documents en onglets, rubriques, sections.

Ces niveaux se retrouvent présentés ainsi sur la fiche produit :

<Image align="center" alt="Capture d’écran 2025-01-27 à 10.23.51.png" width="80% " src="https://files.readme.io/88e87dfc16d324d64ff041c9f02db29a44e0b8c5843357df35e8553bac762921-Capture_decran_2025-04-02_a_10.52.37.png" />

* Dans cette illustration :
  * ## COLOR\_REFERENCE = Onglet eau 1]
  * ## Informations = Rubrique eau 2]
  * GÉNÉRAL = Section eau 3]

<br />

## Accéder à la hiérarchie du type de document :

* Sélectionnez le type de document créé dans la liste déroulante.

<Image align="center" width="50% " src="https://files.readme.io/ce7a142bfaaee00e64003c388f78bb05ae516cd58e3f5d248f34feb50b0a37da-Capture_decran_2025-01-27_a_10.22.12.png" />

<br />

## Ajouter des niveaux :

* Cliquez sur le bouton **Ajouter un\[onglet / rubrique / section / attribut]** à l’endroit souhaité dans l’arborescence :

<Image align="center" width="50% " src="https://files.readme.io/d449bce235dd26a272d388695dc4c413c3f3b159529059ecede8dc7fdd5a5d82-Capture_decran_2025-04-02_a_10.54.43.png" />

Selon le niveau sur lequel vous vous situez, le bouton **Ajouter** propose différentes options :

<Image align="center" width="60% " src="https://files.readme.io/8310f3b785af01a1ae56c18baaa70134bb6bf2459d7cdc18c6ee69cf00525024-Capture_decran_2025-04-02_a_11.00.04.png" />

* **Niveau 0** : Définit le type de document. Le sélectionner permet d’ajouter un onglet de niveau 1.
* **Niveau 1** : Définit un onglet principal. Le sélectionner permet d’ajouter une rubrique de niveau 2.
* **Niveau 2** : Définit une rubrique au sein de l’onglet. Le sélectionner permet d’ajouter une section  de niveau 3.
* **Niveau 3** : Définit une section au sein de la rubrique. Le sélectionner permet d’ajouter des attributs.
* **Niveau 4** : Définit les attributs.

<Image align="center" width="30% " src="https://files.readme.io/0a849f5b88735e2e8656ea11b344a1a78e616dcdae41f19c90ffaf1555363c9c-Capture_decran_2025-01-27_a_16.38.07.png" />

<br />

## Configurer les propriétés de chaque niveau :

* **Nom** : Définissez un nom clair,
* **Code** : Assurez-vous qu’il respecte les règles de nommage (seuls les lettres, chiffres, underscore et tirets **uniquement** sont autorisés),
* **Réorganiser les niveaux** : Opérer par glisser-déposer sur un niveau pour modifier sa position.

<br />

<Callout icon="👍🏼" theme="default">
  ### Bon à savoir

  * Les 5 niveaux hiérarchiques sont obligatoires et les attributs seront toujours disposés au dernier niveau le plus bas.
  * Structurez les niveaux selon les besoins métiers : placez les informations les plus utilisées dans les premiers onglets ou sections pour réduire le temps de recherche et améliorer l'expérience utilisateur.
  * Évitez d'inclure trop d'attributs dans une seule section : cela risque de ralentir le chargement et de rendre l'interface confuse. Créez des sous-sections pour mieux organiser les données.
  * Utilisez des codes hiérarchiques cohérents lorsque vous nommez vos niveaux avec une convention de nommage claire.
</Callout>

***

<br />

# Créer et gérer des attributs

Les attributs définissent les données spécifiques contenues dans vos documents.

<br />

## Ajouter un attribut

* **Sélectionner un niveau** : Dans l’arborescence, cliquez sur le dernier niveau (c'est à dire un niveau 3 section) de la hiérarchie où vous souhaitez ajouter un attribut.

<Image align="center" width="60% " src="https://files.readme.io/3a316ba9ae691ad0fcf1e2ff95a5bba448319a48fa764230b7aea983a8ee9557-Capture_decran_2025-04-02_a_11.03.13.png" />

* **Ajouter un attribut** : Cliquez sur **Ajouter un attribut** dans le panneau de droite.

<Image align="center" alt="Capture d’écran 2025-01-27 à 16.07.37.png" width="20% " src="https://files.readme.io/bd66fe6496545c02fe7f3d36d2871af4a163e8397f8a96f40557d032956af535-Capture_decran_2025-01-27_a_16.07.37.png" />

* **Configurer l’attribut** :

  <Image align="center" width="60% " src="https://files.readme.io/dbc163d59fb62d1fe4ee64b7e4760d3cabb35960f21d2439a1f133761fb0467f-Capture_decran_2025-04-02_a_11.13.15.png" />

  * Nom (obligatoire): Nom explicite de l’attribut.
  * Code (obligatoire): Généré automatiquement ou modifié. Le code doit être unique (doublons interdits)
  * Type d’attribut (obligatoire): Choisissez parmi les types disponibles (texte, date, case à cocher, etc.).
  * Description (facultatif) : Ajoutez une description de l'attribut,
* **Propriétés optionnelles** :

  <Image align="center" alt="Capture d’écran 2025-01-27 à 16.29.09.png" width="60% " src="https://files.readme.io/c6525e5927071711ac22f75ee4b602c9c1aea9f68cd32d2c38377c82b2c3a458-Capture_decran_2025-01-27_a_16.29.09.png" />

  * Données principales : rend l’attribut visible dans le header de la fiche produit

  <Image align="center" width="60% " src="https://files.readme.io/fa5c23bdf1f08cfcc288f1eb91a3e1fd40505a02f15915707d36085722ec3518-Capture_decran_2025-04-02_a_11.05.11.png" />

  * Obligatoire : rendre l’attribut indispensable pour permettre la sauvegarde. L'attribut est identifiable sur la fiche produit par un astérisque à proximité du libellé.

  <Image align="center" width="60% " src="https://files.readme.io/78c8d454b8aa9d671bd7f8f37634575e62fab4199d57e7280b543902ac641020-Capture_decran_2025-04-02_a_11.07.09.png" />

  * Utilisable dans les filtres de recherche : pour exploiter les données de l’attribut dans les filtres de la recherche avancée et dans les widgets.
  * Modifiable dans le PIM : l’attribut peut être modifié sur la fiche produit. Si n'est pas coché, le champ est grisé sur la fiche produit.

  <Image align="center" width="60% " src="https://files.readme.io/80f375c10f8deb7e114163f95cb52afe372319011acac11042b2f43b590ac7d6-Capture_decran_2025-04-02_a_11.09.48.png" />

  * Visible dans le PIM : l’attribut est affiché et visible sur la fiche produit
* Enregistrer : Cliquez sur **Ajouter** pour valider.

<br />

<Callout icon="👍🏼" theme="default">
  ### Bon à savoir

  **Localisation** : Traduisez le libellé de l’attribut dans plusieurs langues si nécessaire en utilisant la fonction localisation

  <Image align="center" width="60% " src="https://files.readme.io/7c7ea6c7d39025e47678d18ab8b94d56fcc457642bdf3c80659c4bbfd2b7aec4-Capture_decran_2025-04-02_a_11.15.09.png" />
</Callout>

<Callout icon="👍🏼" theme="default">
  ### Bon à savoir

  * Choisissez des types d'attributs adaptés qui correspondent au format attendu (par exemple, utilisez _Entier_ pour une quantité, _Texte localisé_ pour des textes traduits).
  * Évitez les attributs inutiles pour limiter la complexité de gestion des données. Assurez-vous que chaque attribut sert un besoin précis et est utilisé dans vos processus métier.
  * Ajoutez des textes d’aide pour les attributs complexes ou spécifiques, cela permet aux utilisateurs de mieux comprendre leur rôle sans besoin d’accéder à la documentation.
  * Vérifiez les droits d’accès aux attributs : Certains attributs sensibles (ex. : prix, codes confidentiels) peuvent nécessiter une visibilité limitée. Certains attributs seront par conséquent visible ou invisible selon les droits spécifiques accordés aux utilisateurs. Pour plus d'informations, voir [Gérer les droits d'accès des utilisateurs](https://docs.quable.com/docs/gerer-les-droits-dacces-des-utilisateurs)
</Callout>

<br />

## Modifier ou supprimer un attribut

* Pour effectuer des modifications :
  * Sélectionnez l’attribut dans l’arborescence
  * Modifiez ses propriétés dans le panneau de droite.
  * Cliquez sur **Modifier** pour valider.

<Callout icon="👍🏼" theme="default">
  ### Bon à savoir

  * Le code et le type d’attribut sont définitifs et ne peuvent être modifiés après création.
  * Les attributs \<document_type_code>_name et \<document_type_code>_description **ne doivent être supprimés**, mais vous pouvez les masquer en désactivant l'option "visible dans le PIM".
</Callout>

* Pour supprimer l’attribut :
  * Sélectionnez l’attribut dans l’arborescence
  * Cliquez sur les 3 points en haut à droite **⁝** dans le panneau de droite,
  * Cliquez sur **Supprimer l’attribut** pour le retirer.

<Image align="center" width="30% " src="https://files.readme.io/c67233561e1590375b311217fe9c9de5fac58f9375ada993d9acd8b69f9958ba-Capture_decran_2025-01-27_a_16.12.32.png" />

❗️ **Action irréversible** : La suppression retire définitivement l’attribut du type de document, ainsi que les valeurs portées par l’attribut sur les fiches produit.

***

<br />

# Conseils pratiques

* **Organisation** : Utilisez des noms explicites pour faciliter la navigation et l’identification des données sur une fiche produit.
* **Règles de création de code** : Ne pas utiliser de caractères spéciaux interdits (pour rappel seuls les lettres, chiffres, underscore et tirets sont autorisés) pour éviter les conflits.
* **Limites** : Respectez les plafonds :
  * 10 000 attributs max sur un PIM,
  * 2 000 attributs par type de document.
* **Documentation** : La réussite du déploiement d’un PIM passe par une maîtrise des processus de gestion des données. Consultez la **documentation fonctionnelle** pour des informations détaillées sur les attributs : [Documentation Quable](https://docs.quable.com/docs/objets-et-attributs).
* Utiliser la barre de recherche en haut de la page **Attributs** pour identifier rapidement un attribut dans votre structure de données.

<Image align="center" width="60% " src="https://files.readme.io/667a2e211e20e3dac4c8486a58f3d2445c0255635bc29f9368ff5445e8360310-Capture_decran_2025-04-02_a_11.21.39.png" />

***

<br />

> 📘 En résumé
>
> **Créer un nouveau type de document**
>
> * Accédez à Modèle de données > Attributs pour créer un type de document.
> * Remplissez un formulaire (nom, code, description, etc.) et sauvegardez.
>
> **Organiser les niveaux hiérarchiques**
>
> * Structurez les fiches en onglets (niveau 1), rubriques (niveau 2), et sections (niveau 3).
> * Configurez et réorganisez ces niveaux via glisser-déposer.
> * Respectez des conventions de nommage claires et limitez les sections trop chargées.
>
> **Créer et gérer des attributs**
>
> * Ajoutez des attributs dans une section (niveau 3) d'une fiche produit.
> * Configurez chaque attribut (nom, type, visibilité, localisation, etc).
> * Évitez les attributs inutiles et respectez les plafonds (2 000 attributs max par type de document).
>
> **Modifier ou supprimer des attributs**
>
> * Les modifications sont possibles a posteriori, sauf pour le code et le type d'attribut.
> * La suppression d’un attribut est irréversible et efface les données associées.
>
> **Bonnes pratiques**
>
> * Simplifiez la navigation en organisant les données selon les besoins métiers et en plaçant les informations clés dans les premiers onglets.
> * Vérifiez les droits d’accès aux attributs sensibles pour éviter les erreurs ou les fuites de données.

<br />

***

# Chapitre suivant

Maintenant que vous savez créer et gérer la structure des fiches produits, découvrons ensemble comment [Créer et gérer les jeux d'attributs](https://docs.quable.com/docs/creer-et-gerer-les-jeux-dattributs).