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

# \<reversexrefs\>

## Summary

The list of [reverse cross-references](../../reference/glossary/reverse_xref.md) at the document or fragment level.

This element is [informational](../universal_format/psml_upload.md) – ignored by upload.

## Usage context

| Element category | metadata |
| --- | --- |
| PSML level | metadata |
| Permitted content | [\<reversexref\>](element-reversexref.md) |
| Permitted parent | [\<documentinfo\>](element-documentinfo.md) [\<locator\>](element-locator.md) |
| HTML equivalent | no equivalent |
| OpenXML equivalent | no equivalent |

## Attributes

This element includes the following attributes:

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| limitreached | [boolean](../datatypes/pageseeder_datatypes.md) | no | Whether the maxReverseXRefs limit has been reached |

### `@limitreached`

This flag is used to indicate whether the maximum number of reverse xrefs that can be displayed has been reached. This limit can be controlled in PageSeeder using the [maxReverseXRefs](../../guide/configuration/properties/global_properties.md) property.

When set to `true`, the list of reverse xrefs is incomplete and limited to the value of *maxReverseXRefs*.

> **Note:** When the number of reverse xrefs exceeds the maximum allowed, there is no guarantee that the same set of reverse xrefs is selected.

## Examples

### Example 1: PSML document

Simple PSML document with multiple xrefs:

```lang-xml
<document id="115" schemaversion="1.4" type="help" 
          date="2022-08-04T14:59:14+10:00" version="current" level="portable">
  <documentinfo>
    <uri id="115"
         external="false"
         mediatype="application/vnd.pageseeder.psml+xml" 
         documenttype="help" 
         created="2022-06-20T14:01:14+10:00" 
         modified="2022-08-04T14:59:14+10:00" 
         scheme="http" host="example.org" port="80" 
         path="/ps/sample/help/terms/sharing.psml" 
         decodedpath="/ps/sample/help/terms/sharing.psml" 
         title="Sharing">
      <displaytitle>Sharing</displaytitle>
      <labels>term</labels>
    </uri>
    <reversexrefs>
      <!-- reverse xrefs are listed here -->
    </reversexrefs>
  </documentinfo>
  <section id="title">
    <fragment id="1">
      <heading level="1">Sharing</heading>
    </fragment>
  </section>
  <section id="content"> ... </section>
</document>
```

### Example 2: image

An image that is referenced by a single document:

```lang-xml
<document id="568" schemaversion="1.4" date="2022-06-20T14:02:24+10:00" 
          version="current" level="metadata">
  <documentinfo>
    <uri id="568" external="false" mediatype="image/png" size="16413" 
         created="2022-06-20T14:01:24+10:00" 
         modified="2022-06-20T14:02:24+10:00" 
         scheme="http" host="example.org" port="80" 
         path="/ps/sample/help/images/edit_button.png" 
         decodedpath="/ps/sample/help/images/edit_button.png" 
         title="Edit button">
      <displaytitle>Edit button</displaytitle>
    </uri>
    <reversexrefs>
      <reversexref uriid="176" href="/ps/sample/help/layout/toolbar.psml" 
                   frag="10" urititle="Document toolbar" 
                   mediatype="application/vnd.pageseeder.psml+xml" 
                   documenttype="help" id="2245" title="" type="none" 
                   forwardtype="image" forwardfrag="default"/>
    </reversexrefs>
  </documentinfo>
  <fragmentinfo/>
  <metadata editid="5033" modified="2022-06-20T14:01:24+10:00"> ... </metadata>
</document>
```

### Example 3: URL

The following example shows the reverse xrefs pointing to a URL document:

```lang-xml
<document id="742" schemaversion="1.4" 
          date="2022-07-22T10:06:36+10:00" version="current" 
          level="metadata">
  <documentinfo>
    <uri id="742" external="true" mediatype="text/html" size="92427"
         created="2022-06-20T14:01:54+10:00" 
         modified="2022-07-22T10:06:36+10:00" 
         scheme="https" host="en.wikipedia.org" port="443"
         path="/wiki/Transclusion" 
         decodedpath="/wiki/Transclusion" 
         title="Transclusion - Wikipedia">
      <displaytitle>Transclusion - Wikipedia</displaytitle>
    </uri>
    <reversexrefs>
      <reversexref uriid="300" 
                   href="/ps/sample/help/transclusion.psml" frag="3"
                   urititle="Transclusion" 
                   urilabels="term" 
                   mediatype="application/vnd.pageseeder.psml+xml"
                   documenttype="help" 
                   id="3186" 
                   title="" 
                   type="none" 
                   forwardtype="link" 
                   forwardfrag="default"/>
    </reversexrefs>
  </documentinfo>
  <fragmentinfo/>
  <metadata/>
</document>
```



## Schema

### XML Schema

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

### Relax Schema

```lang-relax
element reversexrefs {
   attribute limitreached { xs:boolean }?,
   element reversexref*
}
```

## Compatibility

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