Un changelog logiciel liste une nouvelle fonctionnalité ajoutée à une version, un contrat introduit une clause qui n'existait pas avant, une page de conditions générales gagne un nouveau paragraphe. Dans chacun de ces cas, il ne suffit pas d'ajouter du texte au document : encore faut-il signaler clairement que ce passage est neuf, et depuis quand il l'est.
La balise <ins> répond à ce besoin. Elle marque un passage comme ajouté dans une version révisée du contenu, de façon visible et datée, plutôt que de le fondre silencieusement dans le reste du texte comme s'il avait toujours été là.
Définition
<ins> entoure un texte considéré comme inséré dans un document par rapport à une version antérieure. Le navigateur le souligne par défaut, ce qui le distingue visuellement du reste du contenu, mais l'essentiel de sa valeur tient à son sens : <ins> déclare un ajout suivi dans l'historique d'un contenu qui continue d'évoluer, pas une simple mise en forme.
Les mêmes attributs que del
<ins> partage exactement les deux attributs facultatifs de <del>, sa balise complémentaire. L'attribut cite pointe vers une URL qui justifie l'ajout, une note de version, une actualité, un journal des modifications. L'attribut datetime précise la date, au format ISO 8601, à laquelle l'ajout a été enregistré.
<p>
Nouveauté de la version 3.2 :
<ins cite="/journal/versions" datetime="2026-08-15"
>export des rapports au format PDF</ins
>.
</p>Cette symétrie n'est pas un hasard : <del> et <ins> forment une paire pensée dès l'origine pour fonctionner ensemble, l'une marquant ce qui disparaît, l'autre ce qui apparaît à sa place.
Exemple concret : des conditions générales qui changent
Un document juridique révisé illustre bien l'intérêt de la balise. Plutôt que de publier une nouvelle version sans historique, ou une note à part qui se désynchronise vite du texte réel, le document porte lui-même la trace de ses modifications, directement lisible à l'endroit où elles se produisent.
<p>
Article 7 : les données sont conservées pendant 12 mois.
<ins cite="/cgu/historique" datetime="2026-07-01"
>Le titulaire du compte peut demander leur suppression anticipée à tout
moment.</ins
>
</p>Un changelog technique suit exactement la même logique : chaque ligne ajoutée entre <ins> et son équivalent en <del> reconstitue, sans document séparé, l'historique complet d'une fonctionnalité ou d'une clause.
Comme <del>, <ins> est un élément qualifié de « transparent » : il peut entourer un simple mot au fil d'un paragraphe ou un bloc entier, un paragraphe complet voire plusieurs, sans casser la structure du document autour de lui.
ins face à mark
<ins> se confond parfois avec <mark>, une autre balise qui met du texte en évidence. Leur différence tient au moment où elles interviennent. <ins> parle du temps, d'une révision datée d'un document par rapport à sa version précédente : un ajout dans un contrat, une clause nouvelle. <mark> parle de pertinence dans l'instant présent, sans aucune notion d'historique, comme un mot recherché mis en surbrillance dans un résultat de recherche.
| Situation | Balise à utiliser |
|---|---|
| Une clause ajoutée à un contrat, avec une date | <ins> associé à <del> |
| Un terme recherché à mettre en évidence dans un résultat | <mark>, sans notion de révision |
| Une ligne de changelog documentant une nouveauté | <ins> avec les attributs cite et datetime |
Questions fréquentes
ins doit-il toujours contenir un paragraphe entier ?Non, <ins> peut entourer un mot isolé, une phrase ou un bloc complet, selon l'ampleur réelle de l'ajout. Un contrat qui gagne une seule clause peut se contenter d'entourer cette clause précise, sans réécrire le paragraphe qui l'entoure.
ins sans l'attribut cite ?Oui, les deux attributs cite et datetime restent facultatifs. La balise fonctionne très bien sans eux et signale déjà un ajout par sa seule présence. Ils apportent une valeur ajoutée réelle dès que le changement mérite d'être daté ou justifié par une source, ce qui est le cas le plus fréquent en pratique.
ins ressemble à celui d'un lien, est-ce gênant ?C'est en effet une confusion visuelle possible, surtout sur une page qui contient aussi des liens soulignés. Une bonne pratique consiste à distinguer les deux par la couleur en plus du soulignement, pour qu'un ajout signalé par <ins> ne se lise jamais comme un lien cliquable par erreur.