The WebPlatform project has been discontinued when the Stewards partnership agreement ended in September 2015. This site has been frozen, and the assets we have created will remain.


< html‎ | elements
Jump to: navigation, search


This article is In Progress.

W3C Recommendation


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

Overview Table

DOM Interface HTMLModElement


Besides the global attributes the following attributes are supported:

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.
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.


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>
  <del>It is supposed to be sunny and hot.</del>
  <ins>It rained in France so we decided to go to Italy instead.</ins>

View live example


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


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

Specification Status Related Changes
HTML 5.1 W3C Working Draft
HTML 5 W3C Recommendation
HTML 4.01 W3C Recommendation

See also

Related articles


  • ins


  • ins

Other articles

External resources


This article contains content originally from external sources.

Portions of this content come from the Microsoft Developer Network: [Windows Internet Explorer API reference Article]