w:ins (Inserted Content)

Marks content as inserted during tracked-changes revision, carrying author and date information.

Parent elements

Child elements

Description

w:ins is a tracked-insertion wrapper that marks content as having been inserted during a revision. It is defined in ECMA-376 Part 1 §17.13.2.18.

When Track Changes is active, text added to the document is wrapped in w:ins. Applications render inserted text with a visual mark (typically underline + colour). On accepting the revision, the w:ins wrapper is removed but the content is kept. On rejecting, the wrapped content is deleted.

Attributes

Attribute	Type	Possible Values	Description
`w:id`	`ST_DecimalNumber`	Unique positive integer within the document.	Revision identifier.
`w:author`	`ST_String`	Any non-empty string.	The author of the insertion.
`w:date`	`xsd:dateTime`	ISO 8601 datetime, e.g. `2024-01-15T14:30:00Z`.	Timestamp of the insertion.

Examples

<w:ins w:id="1" w:author="Alice" w:date="2024-01-15T10:00:00Z">
  <w:r>
    <w:t>inserted text</w:t>
  </w:r>
</w:ins>

new Inserted(
  new Run(new Text("inserted text")))
{
  Id = 1,
  Author = "Alice",
  Date = new DateTime(2024, 1, 15, 10, 0, 0, DateTimeKind.Utc)
};