---
title: "Element <change>"
source: https://dev.pageseeder.com/api/elements/element_change.html
description: "API Element reference for <change>"
last_updated: 2026-08-07T17:09:54+10:00
tokens: ~1000
---

# \<change\>

## Summary

This element is used to indicate what change took place in a history event. The attributes on the element specify what has been modified during the event.

## Usage context

| Permitted content | `<from>/`[\<assignedto\>](element_assignedto.md), `<to>/`[\<assignedto\>](element_assignedto.md) |
| --- | --- |
| Permitted parent | `<event>` |

## Attributes

This element has the following attributes:

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| type | `enum` | yes | The type of value changed |
| from | `xs:string` | no | The previous value if it exists |
| to | `xs:string` | no | The new value if it exists |

### `@type`

The type of the value that changed, possible values are as follows.

- `title`
- `docid`
- `description`
- `labels`
- `path`
- `hosturl`
- `status`
- `duedate`
- `priority`
- `version`
- `assignedto`

*This attribute was introduced in PageSeeder 5.99.*

### `@from`

The previous value if one exists except for `type=assignedto` where the previous `<assignedto>` element is inside a `<from>` element.

*This attribute was introduced in PageSeeder 5.99.*

### `@from`

The new value if one exists except for `type=assignedto` where the new `<assignedto>` element is inside a `<to>` element.

*This attribute was introduced in PageSeeder 5.99.*

### `@status`

This attribute is specified when the status of the document workflow has changed, its value is the new workflow status.

> **Obsolete:** This attribute was removed in PageSeeder 5.99.

### `@priority`

This attribute is specified when the priority of the document workflow has changed, its value is the new workflow priority.

> **Obsolete:** This attribute was removed in PageSeeder 5.99.

### `@due`

This attribute is specified when the due date of the document workflow has changed, its value is the new workflow due date in format ISO 8601.

> **Obsolete:** This attribute was removed in PageSeeder 5.99.

### `@version`

This attribute is specified when a version has been created on the document, its value is the new version.

> **Obsolete:** This attribute was removed in PageSeeder 5.99.

### `@title`

This attribute is specified when the title of the document has been updated, its value is the new document title.

> **Obsolete:** This attribute was removed in PageSeeder 5.99.

### `@docid`

This attribute is specified when the document ID of the document has changed, its value is the new document ID.

> **Obsolete:** This attribute was removed in PageSeeder 5.99.

## Examples

```lang-xml

<change type="title" to="New document title" />

<change type="status" from="In Progress" to="Completed" />

<change type="assignedto">
  <from>
    <assignedto ...>Sally Brown</assignedto>
  </from>
  <to>
    <assignedto ...>John Green</assignedto>
  </to>
</change>
```

## Schema

### XML Schema

```lang-xml

<xs:element name="change" type="change" />

<xs:complexType name="change">
  <xs:sequence>
    <xs:element name="from" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element ref="assignedto" minOccurs="1" maxOccurs="1"/>
        </xs:sequence>
      <xs:complexType>
    <xs:element>
    <xs:element name="to" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element ref="assignedto" minOccurs="1" maxOccurs="1"/>
        </xs:sequence>
      <xs:complexType>
    <xs:element>
  </xs:sequence>
  <xs:complexType>
  <xs:attribute name="type"   type="xs:string"   use="required" />
  <xs:attribute name="from"   type="xs:string"   use="optional" />
  <xs:attribute name="to"     type="xs:string"   use="optional" />
</xs:complexType>
```

### Relax Schema

```lang-relax

element change{
  attribute type { xs:string }, 
  attribute from { xs:string }?, 
  attribute to { xs:string }?
  element from?
  element to?
}
```

## Compatibility

Changed in PageSeeder 5.99, see previous obsolete attributes and new content model is `<from>` and `<to>` elements only.