This page is In Progress

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

ins

Summary

The ins element represents a range of text that has been inserted (added) into a document.

Overview Table

DOM Interface
HTMLModElement

Attributes

Besides the global attributes the following attributes are supported:

cite
The cite attribute may be used to specify the address of a document that explains the change. When that document is long (e.g. the minutes of a meeting) authors are encouraged to include a fragment identifier pointing to the specific part of that document that discusses the change.
datetime
The datetime attribute may be used to specify the time and date of the change. If present, it must be a valid date string with optional time.

Examples

This example uses the ins element to specify text inserted into a document.

<p>This text existed in the document when it
was written. <ins datetime="1997-10-01T12:15:30-05:00">This
text was inserted on 1 October 1997 at 12:15pm in
the Eastern time zone.</ins></p>

This example uses ins and del elements to explain changes in a document

<p>I <del>am</del><ins>was</ins> on vacation in <del>France</del><ins>Italy</ins>.</p>
<p>
  <del>It is supposed to be sunny and hot.</del>
  <ins>It rained in France so we decided to go to Italy instead.</ins>
</p>

View live example

Usage

 The default behavior of the ins element is as a phrasing-level element, but it can be wrapped around any element within the body.

Notes

The default browser display of ins is underlined.

If you want to underline text, but it is not an insertion, you should use the CSS rule text-decoration: underline on the appropriate element enclosing the text.

If you are looking to emphasize a word or phrase, the em element would be a better choice.

For Internet Explorer 8 and later the value of the cite attribute depends on the current document compatibility mode.

Related specifications

HTML 5.1
W3C Working Draft
HTML 5
W3C Recommendation
HTML 4.01
W3C Recommendation

See also

Related articles

HTML

Text

Other articles

External resources

Attributions