<ins>
Text added to a document, for example in a new version of a terms page or a corrected article.
- Display
- inline
- Closing tag
- Required
- Permitted content
- Transparent content, meaning whatever the parent element allows
Example
#<p>
Access to the course is active for
<del>6 months</del>
<ins>12 months</ins>
from the date of purchase.
</p>Definition and usage
#The <ins> element marks a fragment added to a document during editing: a new clause in a terms page, a correction in an article, an added item on a list. Browsers underline it by default.
It usually appears paired with <del>, which marks removed content. Together they show the reader exactly what changed. The datetime attribute records when the change was made, and cite can point to a page that explains it.
<ins> can wrap anywhere from a few words in a paragraph to whole paragraphs or lists. It can’t, however, start in one paragraph and end in the next. In that situation you need two separate elements.
Most screen readers don’t announce insertions and deletions by default. If the change matters, describe it in words too.
Syntax
#<ins datetime="2026-09-28">added text</ins>Attributes
#URL
The address of a page that explains the change, e.g. a changelog entry. The browser doesn’t display it.date and time
The moment the change was made, in the same format as in the<time>element, e.g.2026-09-28or2026-09-28T14:30-04:00. The browser doesn’t show it, but scripts can read it.
The element also supports all global attributes, such as class, id, style and hidden.
Attributes in practice
#cite
URLThe address of a page that explains the change, e.g. a changelog entry. The browser doesn’t display it.
<p>A refund is available within <ins cite="/changes/terms-2026">30 days</ins> of purchase.</p>datetime
date and timeThe moment the change was made, in the same format as in the <time> element, e.g. 2026-09-28 or 2026-09-28T14:30-04:00. The browser doesn’t show it, but scripts can read it.
<p>The course includes <ins datetime="2026-09-28T14:30-04:00">four projects</ins> for your portfolio.</p>More examples
#<ins datetime="2026-09-28">
<p>New: every lesson now has an audio version.</p>
</ins>Default CSS
#Most browsers display this element with these default styles:
ins {
text-decoration: underline;
}Browser support
#Widely available
Works in all modern browsers, phones included. You can use it without worry.
- Chrome
- Edge
- Firefox
- Safari
Good practices
#- Pair
<ins>with<del>, so it’s clear what replaced what. - If the text should just be underlined, without the meaning "added," use CSS or
<u>. - Describe a change everyone needs to know about in words too, e.g. "Updated on September 28, 2026."
Related entries
#- <del>Text removed from a document, shown struck through to preserve the history of changes.
- <s>Content that’s no longer accurate, such as an old price. The browser strikes it through.
- <u>Text with an annotation that can’t be expressed in words, most often a spelling-error mark.
- <time>A date, time, or duration written clearly for people and, at the same time, understandably for machines.
- <mark>Highlights a piece of text like a highlighter, because it’s relevant in the current context.
Spotted a mistake or missing an example? Write to us.