---

<ins> (Inserted Text)

This element is used to indicate that text has been added to the document.

Standard Syntax

Attributes Defined by Internet Explorer

accesskey="key" (5.5)
contenteditable=" false | true | inherit " (5.5)
disabled="false | true" (5.5)
hidefocus="true | false" (5.5)
language="javascript | jscript | vbs | vbscript" (4)
tabindex="number"(5.5)
unselectable="on | off" (5.5)

Standard Event Attributes

onclick, ondblclick, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup

Events Defined by Internet Explorer

onactivate, onbeforedeactivate, onbeforeeditfocus, onblur, oncontrolselect, ondeactivate, onfocus, onmove, onmoveend, onmovestart, onreadystatechange, onresizeend, onresizestart, ontimeerror

Element Specific Attributes

cite

The value of this attribute is a URL that designates a source document or message for the information inserted. This attribute is intended to point to information explaining why the text was changed.

datetime

This attribute is used to indicate the date and time the insertion was made. The value of the attribute is a date in a special format as defined by ISO 8601. The basic date format is

yyyy-mm-ddthh:mm:ssTZD

where the following is true:

yyyy=four-digit year such as 1999
mm=two-digit month (01=January, 02=February, and so on)
dd=two-digit day of the month (01 through 31)
hh=two-digit hour (00 to 23) (24-hour clock not AM or PM)
mm=two-digit minute (00 to 59)
ss=two-digit second (00 to 59)
tzd=time zone designator

The time zone designator is either z, which indicates UTC (Universal Time Coordinate, or coordinated universal time format), or +hh:mm, which indicates that the time is a local time that is hh hours and mm minutes ahead of UTC. Alternatively, the format for the time zone designator could be -hh:mm, which indicates that the local time is behind UTC. Note that the letter "T" actually appears in the string, all digits must be used, and 00 values for minutes and seconds might be required. An example value for the datetime attribute might be 1999-10-6T09:15:00-05:00, which corresponds to March 6, 2001, 9:15 A.M., U.S. Eastern Standard Time.

Example

<ins cite="http://www.bigcompany.com/
      changes/oct99.htm"
date="1999-10-06T09:15:00-05:00">
The penalty clause applies to client lateness as well.
</ins>

Compatibility

HTML 4, 4.01, XHTML 1.0, 1.1
Internet Explorer 4, 5, 5.5, 6
Netscape 6, 7
Opera 4-7

Notes

Browsers can render inserted (<ins>) or deleted (<del>) text in a different style to show the changes that have been made to the document. Eventually, a browser could have a way to show a revision history on a document. User agents that do not understand <del> or <ins> will show the information anyway, so there is no harm in adding information, only in deleting it.