# Relier vos contenus entre eux

Une référence relie un contenu à un autre, comme un bien à sa ville ou un produit à sa marque. Cet article vous apprend à déclarer un champ de référence, à relier vos contenus dans l’éditeur et à afficher ces liens sur vos pages.

## Comprendre une référence

Une référence relie un contenu à un autre, par exemple un bien à sa ville ou un produit à sa marque. Elle se pose par un champ de référence, que vous nommez et déclarez sur le type du contenu qui pointe.

Le contenu visé est le plus souvent un terme d’une catégorie, mais un champ peut viser n’importe quel type public. Une référence se lit dans les deux sens : le bien affiche sa ville et la page de la ville liste ses biens.

Un type peut porter plusieurs champs vers le même type. Un produit peut ainsi avoir une « Marque principale » et des « Marques partenaires », deux liens distincts vers la catégorie « Marques ».

## Déclarer un champ de référence

Vous devez être administrateur du site.

1. Dans le menu de l’administration, ouvrez **Types de contenu**.
2. Cliquez sur **Modifier** sur la ligne du type qui pointe, par exemple **Produits**.
3. Dans la section **Champs de référence**, cliquez sur **Ajouter un champ de référence**. Une ligne s’ajoute.
4. Dans **Nom de la référence**, saisissez le nom du lien, par exemple `Marque principale`.
5. Dans **Type visé**, choisissez le type des contenus à relier, par exemple **Marques**.
6. Dans **Cardinalité**, choisissez **Unique** ou **Multiple**.
7. Cliquez sur **Enregistrer**.

| Colonne | Effet | Valeur par défaut |
| --- | --- | --- |
| **Nom de la référence** | Le nom du lien, affiché dans l’éditeur et dans les filtres. La clé technique en est tirée. Si elle est déjà prise, `_2` s’y ajoute. | Vide. |
| **Type visé** | Le type des contenus qu’on peut relier. La liste donne chaque type avec son nom technique. | Aucun. |
| **Cardinalité** | **Unique** : un seul contenu relié, comme une marque principale. **Multiple** : plusieurs, comme des marques partenaires. | **Multiple**. |

Renommer un champ garde les liens déjà posés. La croix d’une ligne retire le champ à l’enregistrement.

**Remarque :** Un type visé par un champ de référence ne peut pas être retiré. Retirez d’abord le champ du type qui le porte. [Créer un type de contenu](https://lovelyrender.com/fr/documentation/types-de-contenu/) détaille le retrait d’un type.

Une catégorie visée par un champ apparaît dans le menu de l’administration sous le type qui la vise. [Classer avec une catégorie](https://lovelyrender.com/fr/documentation/classer-avec-une-categorie/) le détaille.

## Relier un contenu dans l’éditeur

1. Ouvrez le contenu dans l’éditeur, par exemple un produit.
2. Dans la barre latérale de droite, ouvrez l’onglet du document, celui qui porte le nom du type.
3. Ouvrez l’onglet **Références**. Chaque champ de référence du type y a son bloc, sous son nom.
4. Cliquez dans le champ **Rechercher…**. La liste montre dix contenus du type visé, par ordre alphabétique.
5. Tapez quelques lettres pour affiner, puis cliquez sur un contenu. Il s’affiche au-dessus du champ.

![L’onglet Références d’une réalisation : le Type de jardin réglé sur Jardin de ville, les Prestations Plantation et Terrasse en bois, chacune avec sa croix, puis la recherche ouverte sur Allées et bordures, Arrosage automatique, Clôture et portail et Éclairage du jardin.](https://static.lovelyrender.com/uploads/2026/10/889-doc-contenus-references.png)

Le lien s’enregistre dès que vous choisissez le contenu. Vous n’avez pas à enregistrer le contenu ouvert. La croix d’un contenu relié le retire aussitôt.

Un champ **Unique** n’affiche plus la recherche une fois un contenu choisi. Pour en changer, retirez-le puis choisissez l’autre.

La recherche propose les contenus publiés, les brouillons et les contenus privés que vous avez le droit de lire. Un contenu relié en brouillon n’apparaît sur votre site qu’une fois publié.

## Afficher les références d’un contenu

Le bloc **Références** affiche, sur la page d’un contenu, les contenus reliés par un champ. Par exemple, la marque d’un produit ou les prestations d’une réalisation.

1. Dans le contenu ou dans le gabarit de son type, ajoutez le bloc **Références**. [Ajouter un bloc](https://lovelyrender.com/fr/documentation/ajouter-un-bloc/) explique comment.
2. Dans l’onglet **Réglages** de la barre latérale, panneau **Champ de référence**, choisissez le **Champ à afficher**.
3. Mettez en forme les deux blocs qu’il contient, décrits dans le tableau qui suit.

| Bloc | Rôle | Réglage |
| --- | --- | --- |
| **Libellé de référence** | Le nom du champ, affiché une fois, par exemple « Marque ». | **Balise HTML**, dans le panneau **Balise du libellé**. Par défaut `span`. |
| **Contenu référencé** | Le modèle répété pour chaque contenu relié. Il porte au départ le titre du contenu. | **Plusieurs contenus** : **En ligne, séparées par des virgules** (par défaut) ou **En blocs (grille ou flex)**, une carte par contenu. |

Le **Contenu référencé** accepte les blocs d’une carte de liste : le titre, l’extrait et le média du contenu relié. Sur un terme qui a des couleurs et une icône, il les prend. [Afficher les données d’un contenu](https://lovelyrender.com/fr/documentation/afficher-les-donnees/) explique comment afficher le titre ou un champ du contenu relié.

Posé dans un gabarit, le bloc lit le champ sur le type du contenu affiché. Un même gabarit sert ainsi tous les types qui déclarent ce champ.

**Remarque :** Si aucun champ de référence n’existe sur votre site, le panneau le dit. Déclarez d’abord un champ dans **Types de contenu**.

## Lister les contenus qui pointent vers une page

Sur la page d’un terme, une liste peut montrer tous les contenus qui le visent : sur la page « Lyon », les biens de Lyon. Vous n’avez pas à les choisir, la liste suit vos références.

1. Ouvrez le terme dans l’éditeur, ou le gabarit des pages de sa catégorie.
2. Ajoutez le bloc **Liste de contenus**.
3. Dans l’onglet **Réglages**, panneau **Requête**, réglez **Source de la requête** sur **Référence**.
4. Facultatif : dans **Champ de référence**, choisissez le champ qui doit pointer. **N’importe quel champ de référence**, le choix par défaut, les accepte tous.
5. Facultatif : dans **Limiter à des types de contenu**, cochez les types à lister. Sans case cochée, la liste accepte tous les types.

![Le panneau Requête d’une liste posée sur le terme Jardin de ville : la source Référence, son explication, le champ de référence Type de jardin et la case Réalisations cochée sous Limiter à des types de contenu.](https://static.lovelyrender.com/uploads/2026/10/899-doc-contenus-requete.png)

La liste vise le contenu affiché : celui dont le contenu porte la liste, ou celui que montre le gabarit. Dans l’éditeur, son aperçu montre déjà les contenus qui visent le terme ouvert.

Choisir un champ précis sert quand un type pointe deux fois vers le même type. Avec « Marque principale », la page de Nike ne liste que les produits dont Nike est la marque principale.

**Remarque :** Un champ par lequel aucun des types listés ne pointe vers le contenu affiché est suivi de **(aucun type listé ne pointe ici par ce champ)**. La liste n’affiche alors rien. Cela arrive quand une liste est copiée d’un gabarit à un autre : choisissez l’un des champs proposés.

**Conseil :** Posez la liste dans le contenu du terme plutôt que dans son gabarit : les assistants IA la lisent dans la version Markdown de la page. Pour la retrouver sur chaque terme sans la refaire, faites-en un modèle : [Partir d’un modèle de contenu](https://lovelyrender.com/fr/documentation/modeles-de-contenu/).

## Lister les contenus rangés de la même façon

Dans le gabarit des pages d’un type qui porte un champ de référence, une liste peut montrer les contenus rangés comme celui qu’on lit. Sur un article de la rubrique « Démarrer », elle montre tous les articles de « Démarrer ».

1. Ouvrez le gabarit des pages du type dans l’éditeur.
2. Ajoutez le bloc **Liste de contenus**.
3. Dans le panneau **Requête**, réglez **Source de la requête** sur **Frères et sœurs**.
4. Dans **Référence partagée**, choisissez le champ que les contenus partagent. Il est choisi d’office quand le type n’en a qu’un.

La liste montre tout ce qui pointe, par ce champ, vers ce que vise le contenu lu. Le contenu lu reste dans la liste, marqué comme le contenu courant. Sa carte prend l’état **Active**, que vous habillez dans l’onglet **Styles** de la carte.

Tant qu’aucun champ n’est choisi, la liste reste vide. La source **Frères et sœurs** n’est proposée que dans le gabarit d’un type qui déclare un champ de référence.

## Filtrer une liste par référence

Une liste de contenus peut proposer à vos visiteurs de filtrer par référence, par exemple par ville ou par marque. Plusieurs valeurs cochées dans un même filtre élargissent le résultat, deux filtres le resserrent. [Lister et filtrer vos contenus](https://lovelyrender.com/fr/documentation/listes-de-contenus/) détaille les filtres.

## Voir aussi

- [Classer avec une catégorie](https://lovelyrender.com/fr/documentation/classer-avec-une-categorie/)
- [Lister et filtrer vos contenus](https://lovelyrender.com/fr/documentation/listes-de-contenus/)
- [Afficher les données d’un contenu](https://lovelyrender.com/fr/documentation/afficher-les-donnees/)
- [Décider de l’apparence avec les gabarits](https://lovelyrender.com/fr/documentation/gabarits/)