---
title: "Element <versions>"
source: https://dev.pageseeder.com/psml/elements/element-versions.html
description: "PSML Element reference for <versions>"
last_updated: 2026-08-07T17:09:54+10:00
tokens: ~435
---

# \<versions\>

## Summary

The list of existing [versions](../../reference/glossary/version.md), if any. *INFORMATIONAL - ignored by upload.*

## Usage context

| Element category | metadata |
| --- | --- |
| PSML level | metadata |
| Permitted content | `<version>` |
| Permitted parent | `<documentinfo>` |
| HTML equivalent | no equivalent |
| OpenXML equivalent |  |

## Attributes

This element includes the following attributes:

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| limitreached | [boolean](../datatypes/pageseeder_datatypes.md) | no | Whether the maximum number of versions has been returned |

### `@limitreached`

This flag is used to indicate whether the maximum number of versions that can be displayed has been reached. This limit is set to 100 and cannot be changed.

When set to `true`, the list of versions is incomplete and only shows the latest 100 versions. To list more versions use [Service: /groups/\{group\}/uris/\{uri\}/versions \[GET\]](../../api/services/list-uri-versions-GET.md).

*This attribute was introduced in PSML v1.4 in PageSeeder 6.00.*

## Examples



## Schema

### XML Schema

```lang-xml
<xs:element name="versions">
  <xs:complexType>
    <xs:sequence>
      <xs:element ref="version"
                  maxOccurs="unbounded"/>
    </xs:sequence>
    <xs:attribute name="limitreached"
                  type="xs:boolean" 
                  use="optional"
                  default="false"/>
  </xs:complexType>
</xs:element>
```

### Relax Schema

```lang-relax
element versions {
  attribute limitreached { xs:boolean }?, 
  element version+
}
```

## Compatibility

This element was introduced in the first draft of PSML and is well-supported from PageSeeder 5.1.